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INTRODUCTION 



This manual describes how to use STSC's 
APL*PLUS/80 System on your Radio Shack® TRS-SO* 
Model III computer. The manual is divided 
into seven chapters that provide the following 
information: 



o Chapter 1 



o Chapter 2 



Describes TRS-80 Model III 
components and controls, disks 
and disk drives, and explains 
how to start your computer and 
begin an APL session. 

Explains how to use your TRS-80 
Model III keyboard during an 
APL session. 



o Chapter 3 



Describes what you will see on 
your display screen during an 
APL session, and explains how 
you can change the display. 



o Chapter n - Explains how you can edit 
information that you enter 
using the keyboard, and what 
your computer will do if you 
type information that 
APL*PLUS/80 can't work with. 



o Chapter 5 



o Chapter 6 



o Chapter 7 



Describes how to properly end 
an APL session and explains why 
these procedures are so 
important. 

Reviews the steps in a typical 
APL session including beginning 
an APL session and ending an 
APL session, and explains how 
to run a stored program. 

Explains a few of your "house- 
keeping" responsibilities. 
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Following Chapter 7 are four appendixes that explain how 
to install the custom APL character generator; how to 
create an APL*PLUS/80 system disk under the TRSDOS™ 
operating system (supplied by Radio Shack); how to 
create an APL*PLUS/80 system disk under the LDOS® 
operating system (supplied by Logical Systems, Inc.); 
and keyboard and display control codes. 

Material at the end of the manual includes a glossary of 
data processing terms, a list of references, and an 
index. 

You don't need any previous knowledge of programming or 
even data processing to use this- manual. All you need 
is a TRS-80 Model III with 48K RAM (Random-Access 
Memory), at least two disk drives, and TRSDOS 
Version 1.3. Your APL*PLUS/80 System will work on a 
TRS-80 Model III with only one disk drive, but you will 
only be able to save a small amount of data. This is 
because you must keep the APL*PLUS/80 system disk in 
disk drive during an APL session since the system 
periodically reads system programs from the disk. 

You can also use APL*PLUS/80 with LDOS Version 5.1. If 
you plan to use APL*PLUS/80 with the LDOS operating 
system, you will find a different set of software 
installation instructions and some notes about running 
APL under LDOS in Appendix C. Once APL is started, its 
operation under LDOS is practically identical to its 
operation under TRSDOS. Refer to Appendix C or your 
LDOS manual for specific instructions on starting the 
TRS-80 with LDOS. 



NOTE 

Please note that even experienced 
BASIC programmers should read this 
manual since TRS-80 operation while 
using the APL*PLUS/80 System is 
substantially different from TRS-80 
operation while using BASIC. 
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The following conventions are used in the text. CONVENTIONS USED 

IN THIS MANUAL 

o Section titles, subsection titles, and keywords 

(words to help you find things you're looking for in 
the text) appear in the margins. Section titles are 
printed in uppercase letters, subsection titles are 
printed with initial capital letters, and keywords 
are printed in lowercase letters. 

o Uppercase letters are used to indicate keys (such as 
CTRL and ENTER) found on your APL*PLUS/80 keyboard, 
and information that appears on your display screen. 

o The APL character set is represented in uppercase 
italic letters. Items in italic letters (such as 
)L0AD CBARSET) represent information that you must 
enter exactly as shown. 

o Words in the text that are underlined represent the 
first occurrence of glossary entries. 

o "Press a key" means to press the key quickly (less 
than one second), just as you would press the keys on 
a push-button telephone when calling a number you 
know. 

In the front inside pocket of your APL*PLUS/80 binder is PREPARING THE 
a sheet of self-adhesive labels. These labels include: KEYBOARD 

o An STSC APL*PLUS/80 System logo that you can apply to 
the front of your TRS-80. 

o Disk drive numbers that you can apply to the front of 
your built-in and exter nal disk drives . 

o A placard with descriptions of APL*PLUS/80 fingertip 
controls that you should apply to the area between 
the video display screen and the keyboard of your 
TRS-80. 

o APL keyboard labels that you should apply to the 
front of the keys on your TRS-80 keyboard. 

You'll also notice that some blank, pre-cut keyboard 
labels are included. You can use these extra labels to 
replace pre-printed labels if the printed symbols should 
wear off with time and use. 
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Take a few minutes now to attach your keyboard labels. 
Turn off the power to your TRS-80 and then follow the 
directions printed on the label sheet. To make keyboard 
label application easier, depress the keys in front of 
the key you are working with. 



INSTALLING THE 
CUSTOM APL 
CHARACTER 
GENERATOR 



One custom APL character generator is supplied with your 
APL*PLUS/80 System. This " chip " . when properly 
installed in your TRS-80 Model III, provides you with an 
accurate display of all APL characters. 

Installing the custom APL character generator in your 
TRS-80 does not affect your ability to enter and run 
BASIC programs . It will, however, change some of the 
special characters that are not contained in the regular 
ASCII character set . 

If you choose not to install the custom APL character 
generator you must use APL*PLUS/80 Keyword Form, where 
keywords are used in place of APL symbols. If you do 
install the custom APL character generator you can 
choose the form you prefer — APL Symbol Form or Keyword 
Form. The APL*PLUS/80 Programmer's Reference Manual 
contains detailed descriptions of APL Symbol Form and 
Keyword Form. The examples in this manual are displayed 
as though you were using APL Symbol Form. 

Before continuing with this introduction, please read 
Appendix A, "Character Generator Installation." 
Appendix A explains how character generator installation 
could affect your TRS-80 warranty, and gives you 
step-by-step directions for installing the character 
generator. 



YOUR COMMENTS 
ARE WELCOME 



We're eager to hear your comments on the APL*PLUS/80 
Computer Operation User's Guide . For your convenience, 
a Feedback Form and postage-paid mailer are included at 
the end of this manual. If the form is missing, please 
send your comments to: 

Publications Department 
STSC, Inc. 

2115 East Jefferson Street 
Rockville, Maryland 20852 

Be sure to include your name and address and the name of 
the manual. 
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CHAPTER 1 
SYSTEM START-UP 



Chapter 1 contains information on the TRS-80 
Model III components and controls, disks and 
disk drives , and system start-up procedures. 
You'll not only learn the names of TRS-80 
Model III components and controls, but you'll 
also learn how to properly care for disks and 
how to start the system and begin an APL 
session. 

Before reading any further, take a few minutes 
to familiarize yourself with the various 
elements of your TRS-80 (see Figure l.l). 
Even if you are an experienced TRS-80 user, 
Figure l.l will introduce you to some 
terminology we will use throughout this 
document. 
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BUILT-IN 
DISK DRIVES 



SYSTEM 
RESET 

BUTTON 



OPTIONAL 
EXTERNAL 




POWER 
SWITCH 



Figure 1.1 TRS-80 Model III Components and Controls 
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CHAPTER 1 



SYSTEM START-UP 



CAUTION 

Disks are fragile. Please read this 
entire section before handling your 
disks. Before reading any further, 
take a few minutes to familiarize 
yourself with the various elements 
of a disk (see Figure 1.2). 



DISKS 




DISK LABEL 



WRITE-PROTECT NOTCH 



DISK JACKET 



READ/WRITE WINDOW 



DISK ENVELOPE 



Figure 1.2 Disk Elements 
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CHAPTER 1 



SYSTEM START-UP 



Disk, diskette, floppy disk, flexible disk — all of 
these words refer to a device that we use for permanent 
and semi-permanent storage of programs and data files . 
For simplicity, we'll just refer to this device as a 
disk. 



disk 



A disk consists of a round, mylar platter that's coated 
with magnetic material and permanently sealed inside a 
5 l/4-inch square protective plastic cover that we call 
the disk jacket . When you insert the disk into a disk 
drive, the platter spins inside the disk jacket at a 
speed of five rotations per second and a special coating 
on the inside of the jacket cleans the platter surface. 
You should never try to clean the platter surface 
yourself or remove the platter from the disk jacket; 
doing so would permanently damage your disk. 

For maximum protection, the disk should always be in one 
of only three places: stored in the disk envelope held 
in your hand, by the edge; or inserted in the disk 

drive. 



disk envelope 



The disk envelope is a paper container used to store a 
disk when it is not in use. To remove the disk from the 
disk envelope, squeeze the sides of the envelope 
slightly and pull the disk out. This way the disk 
envelope won't rub against the exposed surfaces of the 
disk. 



read/write window 



One of the exposed surfaces of the disk is an area 
called the read/write window . This oval opening in the 
disk jacket allows the read/write heads of the disk 
drive to access the platter. Never touch the exposed 
surfaces of the disk; this can permanently damage your 
disk. 



wr ite-protect 
notch 



When you buy a new disk 
uncovered, allowing the 
storing programs and dat 
to change or add informa 
notch uncovered. Howeve 
the information that is 
changed, cover the write 
gummed foil tab (several 
disk) or any gummed labe 
write-protect notch, don 
becomes indented, the di 
the disk is write-protec 



the write-protect notch is 
computer to "write" on the disk, 
a files. If you want to be able 
tion, leave the write-protect 
r, if you want to ensure that 
stored on the disk will not be 
-protect notch with a special 

are supplied when you buy a new 
1. When applying a tab to the 
' t pinch the tab. If the tab 
sk drive might not sense that 
ted. 
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CHAPTER 1 SYSTEM START-UP 

Here are more tips for protecting your disks. protecting your 

disks 
o When your disks aren't in use, store them in the disk 

envelope in an upright position -- just like you 

would store phonograph records. There should be 

little or no pressure against the surface of the 

disk. 

o Never bend the disk. 

o Use only felt-tip pen to write gently on the disk 
label . Lead pencil or ball-point pen might press 
through the disk jacket and damage the disk surface. 

o Don't write on the disk envelope when the disk is in 
the envelope; this can damage the disk surface. 

o Don't insert the disk into the front or back pocket 
of a three-ring binder. The disk could slip under 
the rings, which might damage the disk surface. 

o Avoid contaminating your disks with dust, cigarette 
ashes, or other particles. 

o Keep your disks away from heat and out of direct 

sunlight. 

o Keep your disks away from electric or magnetic fields 
that could erase information that is stored on the 
disks; for example, the fields produced by 
televisions, radios, telephones, magnets, 
transformers, static electricity, and motors other 
than those in your TRS-80 Model III disk drives. 



Copyright 1982 STSC, Inc. -9- APL*PLUS/80 Computer User's Guide 



CHAPTER 1 



SYSTEM START-UP 



DISK DRIVES 



CAUTION 




You may be unfamiliar with TRS-80 


Model III disk drives. Please read 


this entire section before 




attempting to insert a disk 


into a 


disk drive. Before reading 


any 


further, take a few minutes 


to 


familiarize yourself with the 


various elements of a disk ( 


2rive 


(see Figure 1.3). 





DISK DRIVE 



DISK DRIVE 1 DR | VE SELECT light 




DISK DRIVE 3 
DISK DRIVE 2 



DRIVE LATCH 



Figure 1.3 Disk Drive Elements 



Copyright 1982 STSC, Inc, 



■10- 



APL*PLUS/80 Computer User's Guide 



CHAPTER 1 



SYSTEM START-UP 



The typical TRS-80 Model III has two built-in disk 
drives and, without software modification, you can add 
two additional external disk drives. 



Disk drives are usually referred to by disk drive 
number. On the TRS-80 Model III, the bottom disk drive 
is disk drive and the top disk drive is disk drive 1. 
If you have added external disk drives to your TRS-80 
Model III, they are referred to as disk drive 2 and disk 
drive 3. Disk drive numbers also indicate what type of 
disk is used in the disk drive. Disk drive is used 
for the APL*PLUS/80 system disk . Disk drives 1, 2, 
and 3 can contain data disks. 



disk drive 
numbers 



Access to the disk drive is controlled by the drive 
latch . When the drive latch is closed you can't insert 
a disk into (or remove a disk from) the disk drive. The 
drive latches on disk drives and 1 are hinged at the 
top; to insert or remove a disk you must lift the drive 
latch out from the bottom toward the top. On external 
disk drives, however, the drive latch is hinged on the 
right; to insert or remove a disk you must lift the 
drive latch out from the left toward the right. 

When inserting a disk into a built-in disk drive, the 
write-protect notch should be on the left side, the 
read/write window should be on the edge farthest away 
from you, and the disk label should be facing up. Note 
that you should never force the drive latch to close. 
If the drive latch won't close easily, the disk is not 
inserted far enough into the disk drive; forcing the 
drive latch closed may damage the edge of the disk. 
Also note that the drive latch must be closed when a 
disk is in the disk drive; otherwise, the computer won't 
be able to read from the disk. 

Each disk drive has a drive select light . This small 
red light comes on when the computer is trying to use 
the disk drive — even if there's no disk inserted and 
no data transfer is occurring. Note that you should 
never remove a disk while the drive select light is on; 
this can damage data that is stored on the disk. 



drive latch 



inserting a disk 



drive select 
light 
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CHAPTER 1 



SYSTEM START-UP 





IMPORTANT NOTE 


One final note for experienced APL 


prog] 


rammers: you should never 


remove or insert a disk while the 


disk. 


contains open files (files that 


have 


been "opened" by a program); 


othe 


rwise, all or part of your file 


may be lost. If you have been 


work 


ing with files, be sure to close 


them 


by entering QFUNTIE UFNUMS or 


)0FF 


before you remove the disk. 



START-UP STEPS 



Before you can begin working with APL you must perform 
the five start-up steps. The five start-up steps, 
described below, are 

o turn on peripheral devices, if any 

o insert disks 

o turn on your TRS-80 

o adjust the screen display 

o respond to the start-up dialog. 



Turn on 

Peripheral 

Devices 



Before turning on your peripheral devices be sure that 
the computer is plugged in. 

Turn on all peripheral devices (such as external disk 
drives and printer). 
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CHAPTER 1 
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IMPORTANT NOTE 

If your APL*PLUS/80 has never been 
used before, you must generate an 
APL*PLUS/80 system disk before 
proceeding with this section. Refer 
to Appendix B or Appendix C for 
specific information on generating 
your APL*PLUS/80 system disk. 



Insert Disks 



Open the drive latch on disk drive 0. Remove your 
APL*PLUS/80 system disk from the disk envelope, 
carefully insert the system disk into disk drive (see 
Figure 1 . *) ) , and close the drive latch. Insert other 
disks you want to use, if any, into disk drives 1, 2, 
and 3. (Note that these disks must have been formatted 
with the TRSDOS or LDOS operating system's FORMAT 
command, or copied with the BACKUP command from another 
disk. For more information on formatting new disks, see 
Chapter 7, "User Responsibilities".) 





Figure 1.4 Inserting A Disk 
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CHAPTER 1 



SYSTEM START-UP 



Turn on your 
TRS-80 



Turn on your TRS-80. The power switch on your computer 



is located under the right side 
Figure 1.5). Flip the power swi 
computer; you'll hear a humming 
humming sound is made by the dis 
Wait until the disk drive motors 
select light goes off; the compu 
starting the operating system so 
APL*PLUS/80 system disk in disk 
system clock to midnight. 



of the keyboard (see 
tch to turn on the 
and buzzing sound. The 
k drive motors starting. 

stop and the drive 
ter is loading and 
ftware from the 
drive and setting the 




Figure 1.5 Power Switch 
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At this point you can adjust the screen display 
brightness and contrast. The brightness and contrast 
controls are wheels located under the left-hand side of 
the keyboard (see Figure 1.6). You can adjust screen 
display brightness and contrast to comfortable levels as 
room lighting changes, as often as you like. 



Adjust the 
Screen Display 




Figure 1.6 Brightness and Contrast Controls 
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CHAPTER 1 



SYSTEM START-UP 



Respond to the 
Start-up Dialog: 
TRSDOS 



enter 
the date 



enter 
the time 



After you turn on your TRS-8 and the start-up program 
determines that everything is working properly, TRSDOS 
Version 1.3 not only displays a picture of your TRS-80, 
but also displays the TRSDOS version number and date of 
creation, and the amount of RAM and number of disk 
drives in your system. 



First, TRSDOS asks you to enter 
MM/DD/YY; for example, 03/01/82 
the correct date. If you make a 
you can correct the problem by p 
key (■*- on the key top) until the 
incorrect character and then typ 
information. When the date is c 
key. Note that TRSDOS won't all 
unrealistic date (for example, 1 
won't continue until you enter a 
proper format (MM/DD/YY). 



the date in the form 
for March 1, 1982. Type 

mistake while typing, 
ressing the backspace 

cursor erases the 
ing the correct 
orrect, press the ENTER 
ow you to enter an 
3/42/82), and TRSDOS 

date that's in the 



After you enter the date, TRSDOS asks you to enter the 
time in the form HH:MM:SS. You should enter TRSDOS time 
in twenty-four hour format; for example, 14:15:00 for 
2:15 p.m. Type the correct time using the standard 
TRS-80 keyboard to type the colon; that is, press the 
key with a colon ( : ) on the key top, not the key with an 
APL colon on the adhesive label. You can use the 
correction procedures described above if necessary. 
When you have typed the time correctly, press the ENTER 
key. TRSDOS displays "TRSDOS Ready". 



Start-up Dialog 
APL 



You are now ready to begin an APL session. Type APL and 
press the ENTER key. (If you plan to use your computer 
primarily for APL, you can type AUTO APL instead of APL, 
and press the ENTER key. In subsequent sessions, you 
can then skip this step. ) 



IMPORTANT NOTE 

If more than one person will use 
your TRS-80, or if you want to 
protect your files and workspaces 
with a p asswo rd, refer to the 
APL*PL US/80 Progr a mmer's Reference 
Manual and APL*PL U S/80 Shared File 
System User's Guide for information 
about distinct user account numbers, 
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CHAPTER 1 SYSTEM START-UP 

Fifteen to twenty seconds after you press the ENTER key, 
the APL*PLUS/80 System completes loading. While the 
system is loading the screen displays the STSC address, 
the APL*PLUS/80 version- number and serial number, the 
system logo, and a license and copyright notice. After 
the system is loaded, the APL*PLUS/80 normally displays 
a "status line" at the bottom of the screen: 



However, this line might not be displayed if you are 
using an applicatio n that starts automatically for you. 
(For further details on the status line, see Chapter 3, 
"The Video Display".) At this point one of three things 
will happen: 

o You will see a message welcoming you to APL. 

o If another user has dropped the welcome message, you 
will see a message similar to: 

CLEAR WS 3/1/82 2.15.28 WA=2096H 10=1 PP=10 PW=64 

o If you are using an application that starts 
automatically for you, you should refer to the 
documentation for that application to see what will 
be displayed and what you should enter on the 
keyboard. 

Note that you are now using the APL*PLUS/80 System and, 
unless you are using Keyword Form, from this point on 
you must use the APL keyboard as described in Chapter 2, 
"The Keyboard". (See the APL*PLUS/80 P rogrammer's 
Referenc e Manual for more information on Keyword Form. ) 
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CHAPTER 1 SYSTEM START-UP 

SUMMARY OF Remember, before you can begin working with APL you 

START-UP STEPS should: 

o Be sure that the computer is plugged in. 

o Turn on all peripheral devices (such as external disk 
drives and printer). 

o Open the drive latch on disk drive 0, carefully 
insert the APL*PLUS/80 system disk into the disk 
drive, and close the drive latch. 

o Insert other formatted disks you want to use, if any, 
into disk drives 1, 2, and 3. 

o Flip the power switch to turn on the computer, then 
wait until the disk drive motors stop. 

o Adjust the screen display brightness and contrast. 

o Using the standard TRS-80 keyboard (the symbols on 
the key tops), enter the current date and time. 

o Type APL and press the ENTER key. (Note that this 
step is not necessary if you have executed the 
AUTO APL command in a previous session.) 

Enter Date (MM/DD/YY)? 03/01/82 
Enter Time (HH:MM:SS)? 14:15:00 
TRSDOS Ready 

APL 
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CHAPTER 2 
THE KEYBOARD 



Chapter 2 contains information on the APL 
character set labels, shifted and unshifted 
characters, the numeric pad , special keys, 
character repeat , and keyboard and display 
control codes . After reading this chapter 
you'll understand how to use the APL keyboard 
while your computer is running the APL*PLUS/80 
System. 

Before reading any further, take a few minutes 
to familiarize yourself with the various 
elements of your keyboard (see Figure 2.1). 
Compare the keyboard in Figure 2.1 to your 
keyboard. Be sure that the adhesive APL 
character set labels that you have applied to 
the keys are in the correct positions. 
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CO 
O 
S3 

>> 
« 

<1> 



CSJ 



o> 



Copyright 1982 STSC, Inc. 



-20- APL*PLUS/80 Computer User's Guide 



CHAPTER 2 THE KEYBOARD 

Now that you have applied your APL character set labels APL CHARACTER 
and verified that the labels are in the correct SET LABELS 

positions, you need to understand how the characters are 
organized on the labels. 

The first thing you'll probably notice is that the alphabetic and 
labels don't show any alphabetic or numeric characters. numeric 
Since APL*PLUS/80 and TRSDOS use the same keys to characters 
produce alphabetic and numeric characters, you can 
simply refer to the key tops when you want to type an 
alphabetic or numeric character. 

You'll also notice that some portions of the labels are color-coded keys 

color coded. Any symbol in a label portion that is 

color coded must be created with the CTRL key. For 

example, to use the WIPE key to clear the display 

screen, you must hold down the CTRL key while pressing 

the WIPE key. (You'll learn more about using the CTRL 

key in the section "Keyboard and Display Control Codes" 

which begins on page 26). 

Five APL character set labels have characters keys with 

side-by-side. For example, different uses 




APL Symbol Form — ' ' — Keyword Form 



You should always refer to the characters on the left 
side of the label unless you are using Keyword Form, 
when you will refer to the characters on the right side 
of the label. (See the APL*PLUS/80 Programmer's 
Reference Manual for more information on Keyword Form. ) 
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SHIFTED AND 

UNSHIFTED 

CHARACTERS 



Most keys have two symbols -- an uppercase symbol (which 
you'll get when you use the key in combination with the 
SHIFT key) and a lowercase symbol (which you'll get when 
you use the key alone). The uppercase symbol always 
appears on the APL character set label, but the 
lowercase symbol appears on the label only when it is 
different from the symbol on your key top. For example, 





Uppercase =~ 
Lowercase = T 



Uppercase = - 
Lowercase = + 



Alphabetic APL characters are normally displayed in 
uppercase roman font; for example, A B C D E. However, 
alphabetic APL characters with an underbar (SHIFT F) are 
displayed in lowercase roman font. For example, if you 
type A B C D E the display screen will show: 

a b c d e 

Before reading any further, try typing a few characters 
on your keyboard. For example, type an underbar (hold 
down the SHIFT key and press the F key), then type 
NORMAL. Notice that the screen displays NORMAL in 
uppercase roman font. Press the SPACE bar (on the 
bottom of the main keyboard) once or twice to move the 
cursor (the thick, blinking underline) one or two 
positions to the right and type UNDERBAR. These 
characters are also displayed on your screen in 
uppercase roman font. Press the BACK key eight times to 
move the cursor under the U, then type eight underbars 
(hold down the SHIFT key and press the F key eight 
times). Notice that the screen now displays UNDERBAR in 
lowercase roman font. 
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NOTE 




As you proceed through the chapters 
in this manual you'll be doing many 
exercises on your TRS-80 Model III. 


We're sure 
directions 
make a typ 
BREAK key; 

disappear 


you'll try to follow the 
carefully, but if you do 

ing error simply press the 
the line you typed will 

and you can start over. 



To the right of the main keyboard your TRS-80 has a 
small section with twelve keys. This section is called 
the numeric pad. The keys on the numeric pad produce 
the same characters as the numeric keys on the top row 
of the main keyboard -- even when you use the numeric 
keys in conjunction with the SHIFT key or the CTRL key. 
For example, pressing the 1 key on either the numeric 
pad or the main keyboard produces a 1; holding down the 
SHIFT key and pressing the 5 key on either the numeric 
pad or the main keyboard produces an equals sign; 
holding down the CTRL key and pressing the 6 key on 
either the numeric pad or the main keyboard produces a 
right brace ( } ) . 

Before reading any further, try using both the numeric 
pad and the numeric keys on the main keyboard. For 
example, move the cursor several spaces to the right 
(using the SPACE bar) and type 2356 using the numeric 
pad. Now move the cursor several more spaces and type 
2356 using the numeric keys on the main keyboard. 
Notice that both entries look the same on the display 
screen. 

Space over a few more positions and, while holding down 
the SHIFT key, use the numeric pad to type 2356. Space 
over again and repeat the procedure using the numeric 
keys on the main keyboard. Notice that both entries 
displayed: <=>. (If the Radio Shack Character 
Generator Chip is still installed, your display screen 
will show: "<=>. For more information on character 
display, see Appendix A in the APL*PLUS/80 Programmer's 
Reference Manual . ) 



NUMERIC PAD 
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Finally, try the same procedure while holding down the 
CTRL key. Type 2356 on the numeric pad, space over a 
few positions, then use the numeric keys on the main 
keyboard to type the same numbers. Again, both methods 
displayed the same characters; that is, i — 1{}. (If the 
Radio Shack Character Generator Chip is still installed, 
the i — i will display as two different characters.) 

Although the numeric keys on the numeric pad and the 
main keyboard are equivalent, we recommend that you use 
the numeric pad rather than the numbers on the main 
keyboard when you are using them with the CTRL key. 
When you use the numeric pad you are less likely to 
accidentally press an adjacent key that could produce 
undesirable results. 

SPECIAL KEYS Certain keys on the APL keyboard perform special 

functions. These keys and their functions are: 

o BACK -- Moves the cursor one position to the left 
(unless the cursor is in position 1 -- at the left 
margin — on the first line of an input entry). 

o BREAK -- Discards and erases everything from the 
beginning of the current line to the bottom of the 
display screen (except the status line). 

o CTRL — Holding down the CTRL key (CLEAR on the key 
top) while pressing a printing key creates a control 
character. For further information on control codes, 
see the section "Keyboard and Display Control Codes" 
on page 26. For a complete listing of control codes 
and what they do, see Appendix D. A more detailed 
listing is provided in the Appendixes in the 
APL*PLUS/60 Programmer's Reference Manual . 

o ENTER -- Signals the end of typing for the current 
entry and tells the computer to process the entry. 

o KE — Shifts into or out of Keyword Entry to 
automatically complete (if possible) a keyword. 
(Used only when in Keyword Form. See the APL*PLUS/80 
Program me r's Reference Manual for more information on 
Keyword Form. ) 

o RDEL -- Deletes the remainder of the input, and 
erases everything from the cursor to the bottom of 
the display screen (except the status line). 



Copyright 1982 STSC, Inc. -2H- APL*PLUS/80 Computer User's Guide 



CHAPTER 2 THE KEYBOARD 

o SHIFT -- Holding the SHIFT key while pressing a key 
with two symbols produces the upper symbol on the 
key. 

o SLOWER -- If held down during output, displays output 
more slowly. 

o TE -- Shifts into or out of Text Entry (when in 
Keyword Form), in which you can use the SHIFT key 
just like you would on a typewriter to produce upper- 
and lowercase letters. (See the APL*PLUS/8 
Programmer's Reference Manual for more information on 
Text Entry. ) 

Before reading any further, try using a few of the 
special keys. In previous exercises you've used three 
of the special keys (SHIFT, BACK, and CTRL) in 
displaying information on the screen. The line of 
information on your display screen should look something 
like: 

_NORMAL underbar 2356 2356 ~< = > """< = > t— 1{ } i— 1{ } 

Press the BACK key until the cursor is near the center 
of the line, then press the RDEL key. Notice that 
everything from the cursor to the bottom of the screen 
(except the status line) disappears. Now press the 
BREAK key; the entire line disappears. Type l + H and 
press the ENTER key. The computer processes the line, 
and in this case prints the result of this arithmetic 
expression. (You'll learn why this happens in APL Is 
Easy . ) 

Every key on the keyboard that displays a character on CHARACTER REPEAT 

the screen (except when used with the CTRL key) has an 

automatic character repea t feature. Holding down any 

printing key for about 1/2-second produces a sequence of 

the character; that is, the character displays over and 

over again. 

Automatic character repeat is especially useful for 
moving the cursor quickly to the right using the SPACE 
bar (fast-forward spacing), and for moving the cursor 
quickly to the left using the BACK key. 
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IMPORTANT NOTE 

Experienced APL programmers sr 
note that the delay and speed 
repetition are adjustable (see 
Appendix C in the APL*PLUS/80 
Proqrammer's Reference Manual 


lould 
of 

for 


details ) . 





Experiment with the automatic character repeat feature 
before reading the next section. (Remember, you can use 
the BREAK key to erase everything from the current line 
to the bottom of the screen.) 



KEYBOARD AND 
DISPLAY CONTROL 
CODES 



In the APL*PLUS/80, control codes are used to either 
display an additional APL symbol or alter the 
APL*PLUS/80 environment . For instance, if you hold the 
CTRL key and press the 3 key, a right-tack symbol (-0 
displays on the screen. Therefore, CTRL 3 produces an 
additional APL symbol that's not otherwise available on 
the keyboard. Another example is the HELP key, CTRL 0, 
which moves you into the APL*PLUS/80 HELP facility and 
displays a list of topics for which information is 
available. For more information on the HELP facility, 
see the APL*PL US/80 Proqrammer's Reference Manual . 

For a complete listing of available APL*PLUS/80 control 
codes and what they do, see Appendix D or refer to the 
adhesive placard of APL*PLUS/80 fingertip controls that 
you applied to the area between the video display screen 
and the keyboard of your TRS-80. A more detailed 
description of APL*PLUS/80 control codes is provided in 
the APL*PLUS/80 Proqrammer's Reference Manual . 

If there is any information on your display screen, try 
using the WIPE key, CTRL W, to "wipe" the screen clear. 
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Chapter 3 contains information about the 
display screen — what you'll see displayed 
and how you can change the display. After 
reading this chapter you'll know: 

o the APL*PLUS/80 System characteristics, 
screen display, and APL character set 

o about the status line, cursor, six-space 
indent, and tab stops. 
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SCREEN SIZE 



The display screen on your TRS-80 measures 12 inches 
diagonally, and contains 16 horizontal lines that can 
display up to 64 characters per line (see Figure 3.1). 



Figure 3.1 The Display Screen 
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Your TRS-80 can display more than just alphabetic and 
numeric characters. The APL*PLUS/80 character set 
includes special characters and gra phics characters . To 
see all the characters in the APL*PLUS/80 character set 
and learn more about special characters and graphics 
characters, type: 

)L0AD CEARSET 

and press the ENTER key. For a complete list of APL 
characters, you can also refer to Appendix A in the 
APL*PLUS/80 Programmer's Reference Manual . 



CHARACTER SET 



You'll notice that the last horizontal line on your 
display screen often shows a wavy line. This line, 
which consists of 64 tildes (~), is called the status 
line. The status line displays notes that give you 
information about the system; for example, TERMINAL, 
TEXT, EXPAND, KEYWORD, PRINT, HOLD, UNKNOWN OVERSTRIKE, 
UNKNOWN KEYWORD, KEYWORD COMPLETE, OPEN QUOTE (see 
Figure 3.2). 



STATUS LINE 



EXPAND 



Figure 3.2 Sample Status Line 



You'll learn more about status line notes and why they 
appear in Chapter H, "Keyboard Entry Editing." 
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CURSOR 



In the exercises presented in Chapter 2 you learned how 
to display characters on the screen and how to use 
backspacing and underbars to create lowercase 
characters. During these exercises, we referred several 
times to a thick underline called the cursor. The 
cursor indicates your current position on the display 
screen; that is, it indicates where the next character 
you type will appear on the display screen. The cursor 
usually appears as a thick, blinking underline. 
However, if you move the cursor to a position that is 
already displaying a character, the display screen 
alternates between blinking the cursor and blinking the 
existing character. 

Try the following exercise (and be sure to watch what 
the cursor does). Find the cursor on your display 
screen and type a quote (hold the SHIFT key and press 
the K key). Notice that the quote replaces the cursor 
and the cursor moves one position to the right. Now 
type EI and backspace once. The display screen 
alternately blinks the cursor and the I. Hold the SHIFT 
key and press the F key to produce an underbar. The I 
now displays as the lowercase letter i. Now type 
another quote and your display screen should show 'Hi'. 



SIX-SPACE INDENT 



Let's take our previous example one step further. Press 
the ENTER key. Your computer talked back to you! But 
there is one major difference between the 'Hi' that you 
entered and the Hi that your computer returned to you — 
your entry is indented six spaces from the left margin, 
but the computer response begins at the left margin. 
Whenever you're in immediate execution input mode or 
evaluated input mode you'll be able to distinguish your 
entries from system responses by the six-space indent. 
(To learn about the modes of operation, see the 
APL*PLUS/80 Programmer's Reference Manual. ) 



TAB STOPS 



Your APL*PLUS/80 has tab stops preset at every eighth 
position on the line; that is, in positions 1, 9, 17, 
25, 33, 41, 49, and 57. Use the TAB key (CTRL I), just 
as you would use the tab key on a typewriter, to move 
the cursor to the next tab stop. 

When you want to move the cursor more than eight 
positions you can use the TAB key several times, or you 
can simply hold down the SPACE bar to move the cursor 
quickly to the right. 
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Before reading any further, try to display a 1 in 
position 9, a 2 in position 17, and your first name at a 
position you choose on the right side of the screen 
(using the SPACE bar). You can then clear the screen 
using the WIPE key. 
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Chapter 4 contains information on the various 
methods you can use to correct your typing 
errors, and explains the two messages that 
APL*PLUS/80 displays to alert you to specific 
typing errors. After reading this chapter you 
will not only understand how to use the seven 
input editing commands to correct your typing 
errors, but you will also learn the entry 
editing diagnostic messages , what causes them 
to appear, and how to correct the problems. 
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INPUT EDITING 
COMMANDS 



In Chapter 1 you learned that you can correct a typing 
problem during the TRSDOS start-up dialog by pressing 
the backspace key (■*- on the key top) until the cursor 
erases the incorrect character and then typing the 
correct information. But, unless you're in 
APL*PLUS/80 ' s Keyword Form, you can't backspace and 
retype to correct a typing problem like you did in 
TRSDOS. APL*PLUS/80 does, however, provide you with 
seven different methods that you can use to correct 
typing problems. These APL*PLUS/80 input editing 
commands give you much more flexibility, and can often 
save you the time you would spend retyping information 
if you were using TRSDOS. The seven input editing 
commands are explained in the following sections. 



IMPORTANT NOTE 

The following input editing commands 
may not work properly in terminal 
mode. If you will be using your 
TRS-80 to access a remote computer , 
you should refer to documentation 
for the remote computer to learn its 
input editing commands and their 
behavior. 



Backspace 



A backspace, created by pressing the BACK key (the key 
with BACK printed on the adhesive APL keyboard label), 
moves the cursor one position to the left without 
deleting any characters that are on the line. If you 
hold down the BACK key, the cursor will move quickly to 
the left until you release the key or until the cursor 
reaches column 1 of the current line. 



Try using the BACK key. Type your full name, then press 
the BACK key once. The cursor moves one position to the 
left and the display screen alternately blinks the 
cursor and the letter above it. Now hold down the BACK 
key for a second; the cursor moves quickly to the left 
and stops when you release the BACK key. Press the BACK 
key again and hold it down; notice that the cursor stops 
in column 1 even though you haven't yet released the 
BACK key. Release the BACK key and take a good look at 
your display screen. Where's the cursor? It's in 
column 1, six spaces to the left of your name. 
(Remember, information that you enter is indented six 
spaces. ) 
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But how can we call backspace an input editing command 
if it doesn't change any information? Actually, it 
does — if you are editing information in Keyword Form, 
where words are used in place of APL symbols. In 
Keyword Form you can move the cursor under the incorrect 
character and type over the incorrect character to 
replace it — just like you can in TRSDOS. But, in APL 
Symbol Form, you must use backspace in combination with 
character delete or line expansion to correct typing 
problems. (You'll find examples in the sections that 
follow. ) 

Character deletion, performed with the CDEL key (hold Character Delete 

the CTRL key and press the BACK key), deletes the 

character above the cursor. Any characters to the right 

of the cursor shift to the left to fill the space. If 

there aren't any characters above or to the right of the 

cursor, the cursor moves one position to the left and 

any character in that position disappears. Whew! Let's 

try an example. Clear the display screen using the WIPE 

key (CTRL W) . Type: 

I'M CONFUSED 

and press the CDEL key (CTRL BACK) once; the cursor 
moves one position to the left and the D disappears. 
Your display screen now shows: 

I *M CONFUSE 

Use the BACK key to move the cursor under the apostrophe 
('), then press the CDEL key (CTRL BACK) once; the 
apostrophe disappears and M CONFUSE moves to the left to 
fill the space. Your display screen now shows: 

IM CONFUSE 

Watch the display screen closely and use the CDEL key to 

delete M CONFUSE (hold the CTRL key and press the BACK 

key nine times). You can now press the SPACE bar once 
and type : 

UNDERSTAND 
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Your display screen now shows: 

I UNDERSTAND 

Let's take the example one step further by using 
automatic character repeat. Hold the CTRL key and hold 
the BACK key; character deletion repeats and continues 
until you release the keys or until the cursor reaches 
column 1 of the current line. 



Line Expansion 



The EXP key (CTRL E) shifts a line into or out of line 
expansion, so that characters you type are inserted 
above the cursor, and anything already above or to the 
right of the cursor shifts to the right to make room for 
the insertions. For example, use the WIPE key to clear 
the display screen and type: 

APLPLUS/ 80 SYSTEM 

Since there should be a star between APL and PLUS, use 
the BACK key to position the cursor under the P in PLUS; 
the display screen alternately blinks the cursor and the 
P. Now use the EXP key (CTRL E) to shift into line 
expansion (note that EXPAND now displays on the status 
line), and type a star (hold down the SHIFT key and 
press the P key). The star is inserted above the 
original cursor position, and PLUS/80 SYSTEM shifts to 
the right to make room for the insertion. The display 
screen now shows: 

APL*PLUS/80 SYSTEM 

Also notice that the cursor remains under the P in PLUS, 
and that the display screen continues to alternately 
blink the cursor and the P. 

Let's try to change our entry from APL*PLUS/80 SYSTEM to 
APL*plus/80 SYSTEM. Since the cursor is already in 
position (under the P in PLUS), type an underbar (hold 
the SHIFT key and press the F key). Oops! The display 
screen now shows: 

APL*_PLUS/80 SYSTEM 

but we wanted APL*plus/80 SYSTEM. This points out an 
important rule to remember -- to produce a lower case 
letter using underbar (or to create any overstruck 
character), you must first shift out of line expansion. 
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Before proceeding, let's get rid of the unwanted 
underbar. Use the BACK key to move the cursor below the 
underbar, and then the CDEL key to erase the unwanted 
underbar and shift PLUS/80 SYSTEM back one position to 
the left. You can now press the EXP key again to shift 
out of line expansion, and then use underbars to change 
PLUS to plus. Your display screen should now show: 

APL*plus/80 SYSTEM 











NOTE 






Pressing 
key also 


the ENTER 
turns off 


key 
line 


or the 
expans 


BREAK 
ion. 



Take a few minutes to become more comfortable with using 
backspace and line expansion to edit keyboard entries. 
For example, change APL*plus/80 SYSTEM back to 
APL*PLUS/80 SYSTEM; then change APL*PLUS/80 SYSTEM to 
APL*PLUS/80 System. 

In Chapter 2 you learned that control codes are used to Cursor Movement 

either display an additional APL symbol or alter the 

APL*PLUS/80 environment. But you can also use control 

codes when you are editing keyboard entries. As 

described below, CTRL L, CTRL R, and CTRL I move the 

cursor. 

The LEFT key (CTRL L) moves the cursor to the extreme 
left (the first column) of the current line. For 
example, wipe the display screen (use the WIPE key) and 
type: 

CONTROL CODES MOVE THE CURSOR 

Now let's add the word THREE to the front of the line. 
Use the LEFT key (CTRL L) to move the cursor to the 
extreme left, and type: 

THREE 

The display screen now shows: 

THREE CONTROL CODES MOVE THE CURSOR 
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The RIGHT key (CTRL R) moves the cursor to the extreme 
right (just past the last character that is displayed on 
the current line). Let's add a space and two dashes to 
the end of our example. Use the RIGHT key (CTRL R) to 
move the cursor to the extreme right; then press the 
SPACE bar once and the dash key (SHIFT +) twice. The 
line should now look like: 



THREE CONTROL CODES MOVE THE CURSOR -- 

The TAB key (CTRL I) moves the cursor to the next tab 
position. (Remember, tab stops are preset at every 
eighth position on the line.) To finish our example, 
use the TAB key (CTRL I) to move the cursor to the next 
tab position, and type: 



L,R,I. 



Our line now reads: 



THREE CONTROL CODES MOVE THE CURSOR -- L,R,I. 



The RDEL Key 



In Chapter 2 you learned that certain keys on the APL 
keyboard perform special functions. The RDEL key (the 
key with + on the key top) is a special key that deletes 
the remainder of the input line, and erases everything 
from the cursor to the bottom of the screen (except the 
status line). 



Let's use the RDEL key to edit the control code example 
that's already on your display screen. Move the cursor 
under the first dash (use the BACK key) and press the 
RDEL key. Notice that, in this case, everything from 
the cursor to the end of the line disappears, but the 
status line is still displayed at the bottom of the 
screen . 



The BREAK Key 



The BREAK key, another special key, erases and discards 
everything from the beginning of the current line to the 
bottom of the screen (except the status line). Again 
using the control code example that's on your display 
screen, press the BREAK key. The entire line 
disappears, but the status line remains at the bottom of 
the display screen. 



Statement Recall 



You've already learned a number of ways to correct a 
line before you've pressed the ENTER key. But what can 
you do if you press the ENTER key and then realize that 
the line of information your computer processed was not 
really what you wanted? Do you retype the entire line? 
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That's one way to do it, but if the statement you typed 
was long or complex, the first thing you'll probably do 
is wish that you hadn't pressed the ENTER key! Your 
wish comes true when you use something we call statement 
recall. Just type a right parenthesis, ), and press the 
ENTER key, and the statement you typed will reappear on 
the display screen with the cursor at the extreme right 
(just past the last character displayed on the line). 
Try it. Type: 

1 + 5 

and press the ENTER key. The computer processes the 
line and displays the result: 



Perhaps what you really wanted to enter was 1+5+7. 
Type: 

) 

and press the ENTER key to recall the statement. Notice 
that the cursor is at the extreme right, so you can 
simply type +7 to add to the end of the original line. 
Your statement now reads: 

1 + 5 + 7 

Press the ENTER key and your computer displays the 
result -- 

13 



If you now decide that you want to add 1, 3, 5, and 7 
with the numbers in ascending order, do you retype the 
entire line? Do you use statement recall and then 
backspaces so that you can insert +3 in the statement? 
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Both of these methods will work, but there is an easier 
way. If you type ) followed by a number, the statement 
you typed reappears on the display screen with the 
cursor in the position number you've specified. For 
example, type: 



)8 

and press the ENTER key. Your last statement, 

1 + 5 + 7 

reappears on the display screen, and the cursor is in 
position 8 -- under the first +, eight spaces from the 
left margin. You can now turn on line expansion (using 
the EXP key), type +3 to edit the line, and press the 
ENTER key to process the statement: 



1+3+5+7 



16 



You should note that the EDIT key (CTRL Z) works exactly 
like typing a ) — the statement you typed reappears on 
the display screen with the cursor at the extreme right. 







IMPORTANT 


NOTE 


Expe 


rienced APL prog 


rammers should 


note 


that 


statement 


recall is only 


avai 


lable 


in immediate execution 


mode 


and < 


evaluated i 


nput mode. 



ENTRY EDITING 
DIAGNOSTICS 



So far we've seen that APL*PLUS/80 allows you to edit 
entries, and that when you press the ENTER key, 
APL*PLUS/80 will process the statement you've typed. 
But if you type information that APL*PLUS/80 can't work 
with, the status line will display one of two messages 
to alert you to specific problems -- UNKNOWN OVERSTRIKE 
or OPEN QUOTE. 



Unknown 
Overstr ike 



An overstruck character is one that is formed by using 
the BACK key to superimpose one character on top of 
another. For example, in several exercises in 
Chapter 2 you created an overstruck character by using 
an underbar to change an uppercase character to 
lowercase. But even more importantly, you created a 
"legal ov erstrike " — a combination of symbols that was 
recognized and could be processed by APL*PLUS/80. 
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Let's try to type some overstruck characters. Type a n 
(SHIFT C), backspace once, and type a ° (SHIFT J). The 
character you've formed is called the lamp symbol (r) 
and it is a legal overstrike. Now type 1, backspace 
once, and type an underbar (SHIFT F). The display 
screen flashes a "checkerboard" pattern, the characters 
you tried to type disappear from the display screen, and 
the status line now displays the message UNKNOWN 
OVERSTRIKE. APL*PLUS/80 is alerting you that you typed 
an overstrike that it doesn't recognize. You can now 
enter information as though you'd never made the entry. 
As soon as you type a character, that character displays 
on your screen and the UNKNOWN OVERSTRIKE message 
disappears from the status line. 



NOTE 

Experienced APL programmers should 
note that: 

o The UNKNOWN OVERSTRIKE message 
does not appear in Keyword Form. 

o In other APL systems, the UNKNOWN 
OVERSTRIKE message does not 
itself appear, but is grouped 
into a larger category of error 
messages called CHARACTER ERROR 
or INPUT ERROR. 



It's interesting to note that the BACK key can be used 
with UNKNOWN OVERSTRIKE to edit entries. Let's see how 
it works. Use the WIPE key to clear the display screen 
and type : 

APL*PLUS-BO IS EASY TO LEARN 

We can use UNKNOWN OVERSTRIKE to change the dash to a 
slash so our corrected entry will be APL*PLUS/80 IS EASY 
TO LEARN. Use the BACK key to move the cursor under the 
dash, then type a numeric character from 1 to 9 . Since 
no legal overstrike on the APL*PLUS/80 System is formed 
with these numeric characters, the screen flashes, the 
dash disappears, and UNKNOWN OVERSTRIKE appears in the 
status line. Now, simply type a slash and your 
corrected entry will read: 

APL*PLUS/8 IS EASY TO LEARN 
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EDITING KEYBOARD ENTRIES 



Open Quote 



Another message that appears in the status line to alert 
you to a problem is OPEN QUOTE. Let's go back to an 
exercise you did in Chapter 3. Use the WIPE key to 
clear the display screen and type: 

and press the ENTER key. The computer responds with: 

HI 

APL*PLUS/80 simply repeats the statement that you 
enclosed in quotes. Now type: 



'271 

and press the ENTER key. The display screen flashes a 
"checkerboard" pattern, and the status line now displays 
the message OPEN QUOTE. APL*PLUS/80 is alerting you 
that didn't type two (or a multiple of two) quotes, and 
that it can't process the line until you type an even 
number of quotes. In this example, type a quote after 
the I; the OPEN QUOTE message will disappear from the 
display screen and you can now press the ENTER key. 



NOTE 

Experienced APL programmers should 
note that: 

o The OPEN QUOTE message does not 
appear in character input mode. 

o The OPEN QUOTE message does not 
appear if there are unmatched 
quotes after a lamp symbol. 
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CHAPTER 5 
SYSTEM SHUT-DOWN 



Chapter 5 contains information on how to 
properly shut down your TRS-80. You will not 
only learn the proper system shut-down steps, 
but you'll also learn why performing these 
steps is so important. 
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SYSTEM SHUT-DOWN 



SHUT-DOWN STEPS 



When you are finished working with your computer you 
must perform four shut-down steps. The four shut-down 
steps, described below, are: 

o save your data and programs 

o end the current APL session 

o remove all disks 

o power-off your peripheral devices and TRS-80. 



Save Your Data 
and Programs 



Information that you store during a session with your 
TRS-80 is saved in the computer's memory. But when you 
turn off the computer, its memory (like the memory of 
many calculators) is erased. This may not be a problem 
if you've only stored one or two items that can easily 
be reentered the next time you use your computer. But, 
more often than not, you'll find that you've stored many 
programs and data items that you'll want to use later. 

To save information for later use, use the )SAVE 
command. Since you must be able to later identify the 
information so you can retrieve it, you'll need to give 
the set of information a name. Simply type )SAVE, press 
the SPACE bar once, type the name that you want to use 
to identify the information, and press the ENTER key. 
(You'll learn more about storing information, saving 
information, and recalling information in APL Is Easy . ) 

For example, you could type: 

)SAVE PARTONE 

When you pressed the ENTER key, your display screen 
would then show something like: 

1 PARTONE SAVED 05/22/82 16:41:25 WA=19682 ... 





NOTE 




Remember, since 


you must be able 


to 


later identify 


the information so 


you can retrieve it, you should also 


label the disk 


in disk drive 1 with 


the name you us 


ed when you saved 


the 


information. 
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At the beginning of the next session, you can retrieve 
stored information using the )LOAD command. Just type 
)L0AD, press the SPACE bar once, type the name you used 
when you saved the information, and press the ENTER key. 
Continuing with our previous example, you could type: 

)L0AD PAETONE 

When you pressed the ENTER key, your display screen 

would then show something like: 

1 PARTONE SAVED 05/22/82 16:41:25 WA=19682 ... 

Your system displays this line to confirm that the 
information has been "loaded" into your computer's 
memory. Notice that the information in this line is 
exactly like the information in the line that was 
displayed when you used the )SAVE command. 

After you save your data and programs, you must end your End the Current 
APL session by typing )0FF and pressing the ENTER key. APL Session 
)OFF doesn't save any information, but it does close any 
files that are still open and return you to the TRS-80 
operating system, displaying "TRSDOS Ready" (or "LDOS 
Ready" ) . 

Next, you should remove all disks from your built-in and Remove All Disks 
external disk drives. When removing a disk, lift the 
drive latch, carefully pull the disk out of the disk 
drive, replace the disk in its protective storage 
envelope, and store it in an upright position. 

Turn off all peripheral devices (such as external disk Power-off Your 
drives and printer); then flip the power switch to turn Peripherals and 
off your TRS-80. TRS-80 



Copyright 1982 STSC, Inc. -45- APL*PLUS/80 Computer User's Guide 



CHAPTER 5 



SYSTEM SHUT-DOWN 



SUMMARY OF 
SHUT-DOWN STEPS 



Remember, when you are finished working with your 
computer you should: 

o Save any information you want to use later on a data 
disk by typing )SAVE, pressing the SPACE bar once, 
typing the name that you want to use to identify the 
information, and pressing the ENTER key. 

o End your APL session by typing )OFF and pressing the 
ENTER key. 

o Remove all disks from your built-in and external disk 
drives, place the disks in their protective storage 
envelopes, and store the disks in an upright 
position. 

o Turn off all peripheral devices (such as external 
disk drives and printer) and your TRS-80. 



Copyright 1982 STSC, Inc. 



-46- APL*PLUS/80 Computer User's Guide 



CHAPTER 6 
SAMPLE APL SESSION 



Chapter 6 reviews the steps necessary to begin 
an APL session and end an APL session, and 

explains how to run a stored program. Within 
the chapter we have provided examples of what 
you might see on your display screen as you 
proceed through the various steps. As you 
read this chapter you should actually restart 
your computer, run the stored program 
following the steps provided, and then shut 
down your computer. After reading this 
chapter you will be ready to read APL Is Easy 
and begin experimenting with APL. 
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SAMPLE APL SESSION 



START-UP STEPS 



As you learned in Chapter l, before you can begin 
working with APL you must perform a number of start-up 
steps. Restart your computer now by performing these 
start-up steps: 



o Be sure that the computer is plugged in. 

o Turn on all peripheral devices (such as external disk 
drives and printer). 

o Open the drive latch on disk drive 0, carefully 
insert the APL*PLUS/80 system disk into the disk 
drive, and close the drive latch. 

o Insert other formatted disks you want to use, if any, 
into disk drives 1, 2, and 3. 

o Flip the power switch to turn on the computer, then 
wait until the disk drive motors stop. 

o Adjust the display screen brightness and contrast. 

o Using the standard TRS-80 keyboard (the symbols on 
the key tops), enter the current date and time. Your 
display screen will show something like: 

Enter Date (MM/DD/YY)? 03/01/82 
Enter Time (HH:MM:SS)? 14:15:00 
TRSDOS Ready 

o Type APL and press the ENTER key. (Note that this 
step is not necessary if you have executed the 
AUTO APL command in a previous session.) Your 
display screen will show: 

APL 



RUN A STORED 
PROGRAM 



To give you experience in retrieving and running a 
stored program, we have included a special program on 
your APL*PLUS/80 system disk. This program is stored 
under the name DEMO. When you run the program, it 
describes (on your display screen) what kinds of things 
you will see and what you must do to make the program 
run properly. Run the DEMO program now by typing 
)L0AD DEMO and pressing the ENTER key. Your display 
screen will show something like: 

)LOAD DEMO 
DEMO SAVED 04/12/82 17:35:21 WA=21903... 
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When you are finished working with your computer you SHUT-DOWN STEPS 
must perform four shut-down steps. Shut-down your 
computer now by performing these shut-down steps: 

o Save your information on a data disk by typing )SAVE, 
pressing the SPACE bar once, typing the name that you 
want to use to identify the information and pressing 
the ENTER key. 

)SAVE FIRST 
1 FIRST SAVED 06/12/82 10:26:0** WA=22861... 

o End your APL session by typing )0FF and pressing the 
ENTER key. Your display screen will show: 



TRSDOS Ready, 



Remove all disks from your built-in and external disk 
drives, place the disks in the disk envelopes, and 
store the disks in an upright position. 

Turn off all peripheral devices (such as external 
disk drives and printer) and your TRS-80. 
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CHAPTER 7 
USER RESPONSIBILITIES 



Chapter 7 contains information on various 
"housekeeping" duties that you should perform. 
These duties include: cleaning, formatting, 
and making back-up copies of disks; 
compressing data files; and designing file 
storage. 
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USER RESPONSIBILITIES 



People who use a time sharing terminal connected to a 
large computer depend on the computer operations staff 
to maintain the computer, provide back-up, and perform 
other "housekeeping" functions needed to ensure smooth 
operation. In contrast, a person who uses a 
self-contained computer such as the TRS-80 Model III not 
only receives the benefits of total control and 
availability of the computer, but also has the 
operations responsibility for it. 



CLEANING 
DISK DRIVES 



Disk drives are a lot like tape recorders; they must be 
kept clean or the results may be less than perfect. You 
should purchase a disk cleaning kit and use it as 
instructed every two to four weeks. 



FORMATTING 
NEW DISKS 



Before using a new disk to store information, you must 
format the disk. This simple procedure, which uses the 
TRSDOS FORMAT command, is described in detail in the 
TRS-80 Model III Disk System Owner's Manual (or in the 
LDOS User's Manual). 



We suggest that you always keep several formatted disks 
on-hand in case they are needed unexpectedly. For 
example, if your current disk becomes full you will need 
to insert a new formatted disk. If you have to end your 
APL session to format a disk, you'll lose the 
information stored in the computer's memory. So, we 
repeat: Always keep several formatted disks on hand . 



MAKING BACK-UP 
COPIES OF DISKS 



The process of copying all of the data files from one 
disk to another is called back-up. As the name 
suggests, having a duplicate copy of your data files on 
a second disk protects you in case data on one of the 
disks is lost or damaged because of a computer 
malfunction or human error. Problems that can damage 
your disks can include anything from spilling coffee on 
your disk, to small children finding the disk a new and 
interesting playtoy, to the failure of an electronic 
device. Data can also be lost by inadvertently 
executing the wrong system command or even misspelling a 
file name. 



A good rule to remember is that you should never use 
your only copy of an important disk -- except to make a 
back-up copy. 
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The procedure for making a back-up disk is described in 
detail in the TRS-80 Model III Disk System Owner's 
Manual (or in the LDOS User's Manual). However, you may 
remember that you made back-up copies when you created 
your APL*PLUS/80 system disk. In summary, to make a 
back-up copy: 

o When TRSDOS displays "TRSDOS Ready", type BACKUP and 
press the ENTER key. TRSDOS loads and starts a 
program called BACKUP, and asks you to enter the 
source drive number. Type the number of the disk 
drive that contains your original disk and press the 
ENTER key. 

o If the disk you want to back up is not the 

APL*PLUS/80 system disk, you can now remove the 
APL*PLUS/80 system disk from disk drive 0, and insert 
the disk you want to back up in disk drive 0. 

o After you enter the source drive number, TRSDOS asks 
you to enter the destination drive number. Type the 
number of the disk drive that contains the new, blank 
disk that will become your copy, and press the ENTER 
key. 

o TRSDOS now asks you to enter the source disk master 
password. Type PASSWORD (or, if you've changed it, 
the password that you've assigned to your source 
disk) and press the ENTER key. TRSDOS will now copy 
everything from the original disk to the new, 
formatted disk. 

o When the copying process is complete, remove your 
original disk, insert it in the disk envelope, and 
store it in a safe place. Remove the back-up copy 
you have just made of your original disk, and insert 
it in the disk envelope. Using a felt-tip pen to 
write gently on the disk label, identify the disk, 
and store it in a safe place. 

If you're just learning to use APL, the idea of COMPRESSING 

compressing (or "compacting") data files may be somewhat DATA FILES 

confusing; you may want to skip over the information in 

this section. However, this information is important to 

people who use programs that have data files with 

"expanding" component replacements; that is, replacement 

components (records) which, when rewritten to the disk, 

are larger than the original components. Data file 

compression is also important to people who use programs 

that drop components from files. Each of these normal 

processes leaves unused file space that cannot be used 

again unless you compress the file. 
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If you are running an application program package that 
was written by someone else, compression of data files 
is probably built into the package. All you need to do 
is follow the documentation provided with the 
application package. However, you should verify that 
compression is not only incorporated into the package, 
but also that it is necessary. 

If you do need to compress your data files, the 
procedure is explained in detail in the APL*PLUS/80 
Shared File System User's Guide and the APL*PLUS/80 
Programmer's Reference Manual . (Note that after you 
have compressed the data files on a disk you should make 
a back-up copy of the disk.) 

FILE SIZE It is possible for you to create a file that becomes so 

DESIGN large that it can't get any larger. You can compress 

the file to reclaim unused file space, but only if the 
amount of available space remaining on a disk in the 
system is equal to (or greater than) the size of the 
useful data space in the file. Therefore, you should be 
careful not to "paint yourself into a corner" by writing 
programs that don't leave enough space on the disk to 
allow compression. The actual file size limit depends 
on many factors, but for a typical TRS-80 Model III with 
two disk drives, the maximum file size should be 100,000 
to 1*40,000 bytes of useful data space. 
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CHARACTER GENERATOR INSTALLATION 



One custom APL character generator is supplied with your WHAT THE CHARACTER 
APL*PLUS/80 System. This "chip", when properly GENERATOR DOES 

installed in your TRS-80 Model III, provides you with an 
accurate display of all APL characters. 



The APL*PLUS/80 as delivered 
installing the custom APL ch 
the APL characters, such as 
correctly. Others will disp 
original character set that 
characters. For example, fl 
take (t) is a little man (£ ) 
(*-) is a wavy equals sign (» 
APL*PLUS/80 Programmer's Ref 



to you will run without 
aracter generator. Some of 
p and i, will be displayed 
lay as characters from the 
are similar to the true APL 
oor (L) is a lambda (A), 
, and the assignment arrow 
) . See Appendix A in the 
erence Manual for a complete 



listing of APL characters. 



Two important issues relating to your TRS-80 Model III 
warranty should be considered before installing the 
custom APL character generator. 

When you purchase a new TRS-80 Model III, you get a free 
90-day warranty. This warranty is voided, however, if 
you remove the cover of your TRS-80 Model III. After 
your free 90-day warranty expires you can purchase a 
service agreement from Radio Shack. Removing the cover 
of your TRS-80 Model III can also affect your service 
agreement. At the discretion of your local Radio Shack 
manager, you may incur an extra charge for your next 
service call. At the time this publication is being 
written, Radio Shack also has a policy, to which most 
managers strictly adhere, against Radio Shack employees 
installing non-Radio Shack parts or features. 

We suggest that you discuss these issues with your local 
Radio Shack manager and request that a certified Radio 
Shack technician perform the 20-minute installation of 
your APL*PLUS/80 custom APL character generator. 
However, if Radio Shack declines to install the 
component, the section that follows explains the 
installation process. 



HOW IT AFFECTS 
YOUR WARRANTY 
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INSTALLATION To install the custom APL character generator you will 
PROCEDURES need a Number 2 Phillips screwdriver and a small pocket 

knife or integrated-circuit puller. Note that sizes of 
Phillips screwdrivers are not interchangeable; be sure 
to use a Number 2. 

You might like to ask a friend to read the installation 
instructions to you as you work; you'll find that the 
installation process will proceed more quickly than it 
would if you read the installation instructions 
yourself. 

Before starting to install the custom APL character 
generator, read all the instructions that follow. Plan 
to carefully record which screw comes from which hole so 
that you can replace each screw correctly. 

1. Select as your work surface a table that is at 
least five feet wide. 

2. Clear off the table and put down several layers of 
newspaper covering a three-foot square area. This 
will prevent scratching the paint on the computer's 
cover when you are sliding your TRS-80 on its side 
or back. 

3. Place your TRS-80 on the table. 

4. Remove all cables from the bottom and rear of the 
computer . 

5. Disconnect the power cord from any power source. 

6. Place your computer on its back with the bottom 
facing you. 

7. There are nine screws of different types (threads) 
and lengths around the perimeter of the case bottom 
and one screw under the sticker that says BREAKING 
SEAL VOIDS YOUR SERVICE WARRANTY. Before removing 
these screws, take a sheet of paper, roughly sketch 
the bottom of the case, and mark the position of 
each screw. 

8. Use a few pieces of tape at the front of the 
keyboard to hold the top and bottom parts of the 
case together as you remove the screws. 
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9. Remove the ten screws from the case bottom using a 
Number 2 Phillips screwdriver. As you remove each 
screw, push it through the paper in the proper 
location on the sketch you have drawn. Note that 
when you are removing the two recessed screws from 
the case, tilting the case forward makes removing 
the screws easier. (The rubber feet should not be 
unscrewed from the case bottom. ) 

10. While holding the top and bottom parts of the case 
together at the rear of the keyboard area carefully 
place the computer on its feet (right side up). 

11. Remove any tape you have applied at the front of 
the keyboard; you no longer need to hold the top 
and bottom parts of the case together. 

12. Rotate the computer one-half turn so that its back 
is facing you. This can easily be done by turning 
the newspaper under the computer (rather than 
lifting the computer to turn it). 

13. Remove the single screw in the back and place it in 
the appropriate location on your diagram. 

14. Rotate the computer another one-half turn so that 
the front is again facing you. 

15. If you have a light, shine it in the ventilation 
holes in the top. You'll see that part of the 
display screen tube sits very close to the back of 
the case and to surrounding components. You might 
also note that many of the connecting wires are 
very short. 

16. Move the computer to the right side of your working 
area so that there is room on the left to place the 
top part of the case. When lifting the top part of 
the case, don't allow the end of the display tube 
to touch the assembly behind it. Very slowly and 
carefully lift the top part of the case straight up 
about four inches. (Don't be surprised if it's a 
little difficult to lift the top part of the case 
-- the case top and the display screen tube that's 
attached to it weigh almost 15 pounds.) 

17. Look in the opening in the case for the top disk 
drive; you can see the back of the display screen 
tube and the wires connecting the top and bottom 
parts of the computer. 
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18. Being very careful not to jolt the display screen 
tube or pull on the short wires, continue lifting 
the right side of the case without lifting the left 
side. 

19. Lay the top part of the case on its left side (with 
the display screen facing you) next to the bottom 
of the case. 

20. While keeping the top case next to the bottom case, 
turn both assemblies simultaneously one-half turn 
so that the back of the computer faces you. Again, 
turning the newspaper under the computer is easier 
than lifting the computer. 

21. The RF (Radio Frequency) shield is a large vertical 
metal plate that covers the back of the computer. 
(Earlier models of the TRS-80 Model III do not have 
an RF shield. If your TRS-80 is one of these 
earlier models, skip to step 26.) There are five 
(or possibly six) lM-inch screws around its 
perimeter; the screws have two different kinds of 
threads — some have washers and some hold down 
ground lugs. Before removing these screws, take a 
sheet of paper, roughly sketch the RF shield, and 
mark the position of each screw. 

22. Remove the five (or six) screws from the RF shield. 
As you remove each screw, push it through the paper 
in the proper location on the sketch you have 
drawn. 

23. Near the top left edge of the RF shield a small 
black prong projects into an opening in the shield, 
holding the RF shield in place. Locate this pin. 

24. Carefully pry the RF shield away from the pin, and 
move the top of the RF shield toward you. 

25. Allow the top of the RF shield to drop down and 
hinge on the adhesive tape at the bottom of the RF 
shield. Don't allow the RF shield to rest against 
any electronic components at the back of the 
computer. 
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26. 



IMPORTANT NOTE 

Before proceeding with the next step, read the 
following notes on installing integrated circuits 
such as your custom APL character generator. 

o Integrated circuits (ICs) can be damaged by the 
static electricity that is easily generated by 
handling or by storage in non-conductive 
materials. When not installed in a circuit 
board, ICs must be stored in protective, 
conductive material such as the foam supplied 
with your custom APL character generator. Use 
this piece of conductive foam to store the 
original character ROM that you will remove. 
The original character ROM can be reinstalled in 
the future if you desire. 

o We suggest that before removing the original IC, 
you note its position in the socket. This is a 
good indication of the proper position of the 
correctly installed replacement. The IC may not 
need to be inserted far enough for the ceramic 
body to actually touch the socket. 

o Excess force while installing or removing an 
integrated circuit can bend or break off the 
pins which fit into the socket. Use the minimum 
force required and apply the force evenly (so 
that both ends of the IC move at the same rate) 
or in small amounts at opposite ends of the IC. 
If a pin is bent it MUST be straightened before 
you attempt to insert it in a socket or in 
conductive foam. Use tweezers or needle-nose 
pliers, with as little force as possible, to 
straighten the bent pin. If one pin on an IC is 
bent the pin may break when insertion force is 
applied. Be very gentle. 

o When installing a new IC, you should note that 
the pins may not be quite perpendicular to the 
IC case. It is common for the pins to be 
slightly and uniformly bowed. If the rows of 
pin tips are too far apart to start easily into 
the socket, insertion will be easier if you bend 
the pins slightly so that they are uniformly 
perpendicular. To ensure uniformity, place the 
row of pins against the table top and gently 
press down. If necessary, bend both rows an 
equal small amount. 
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o Although ICs appear to be symmetrical, they will 
NOT work if inserted backward. Both the IC and 
the socket have a small notch (or dot) on one 
end. Notice the orientation of the original 
part before removing it, and when inserting the 
new IC, be sure that the notch (or dot) on the 
IC and on the socket are properly aligned. 

o Once an IC is correctly started into its socket 
it may require considerable force to complete 
insertion. This force will not damage the IC or 
the socket, but may bend the printed circuit 
board. Place your thumb or finger next to the 
socket on the opposite side of the circuit 
board. Push against the circuit board while 
pushing on the IC until it is fully inserted. 
This will balance the force and prevent the 
damage that might occur if the circuit board is 
bent. 

27. Locate U36, the character generator ROM IC. U36 is 
located in the upper left quarter of the CPU board 
(as you face it from the back of the computer). 
The part number (U36) is written on the printed 
circuit board above the IC, and the IC itself may 
have the Radio Shack part number 804-4316 printed 
on it. U36 is the only 24-pin IC that is mounted 
horizontally on the CPU board. 

28. Using a pocket knife or an IC puller, place the tip 
of the knife blade 1/8-inch under the end of the 
IC. 

29. Slowly and carefully twist the blade so that the IC 
rises very slightly (about 1/32 of an inch). 

30. Note that as the IC pins rise out of the socket 
they become easier to lift. Be sure to apply the 
lifting force so that the IC is removed with the 
pins on both ends, as well as both sides, rising 
evenly. Completely removing one end of the IC 
before starting to lift the other end will bend the 
pins. 

31. Repeat the procedure by alternating ends of the IC 
until it is free of the socket. 
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32. Remove the custom APL character generator from its 
storage container, and from the protective, 
conductive black foam packing by lifting it 
straight up. Completely removing one end of this 
IC from the conductive foam before starting to lift 
the other end will bend the pins. 

33. Align the custom APL character generator with 
socket U36. This IC should be inserted with the 
notched end on the right. 

34. Start the insertion very gently until all 24 pins 
are partially inserted into the socket. 

35. Place your finger behind the circuit board to brace 

it. 

36. Once the IC is started into the socket, push on it 
with two or three fingers to distribute the 
insertion force evenly across the body of the IC. 

37. Insert the pins of the original character generator 
ROM into the protective, conductive black foam 
supplied with your APL*PLUS/80, and place the foam 
in its storage container. 

38. Store the container in a drawer or other safe place 
in case you want to reinstall the original chip at 
some later date. 

39. Replace the RF shield using the five (or six) 
screws that you removed from the shield in 
step 22. Be certain that you reattach the two 
ground lugs you removed, and that you return the 
screws to their original locations. 

40. While keeping the top case next to the bottom case, 
turn the newspaper under the computer (so that both 
assemblies move simultaneously) until the front of 
the computer faces you. 

41. Very carefully lift the top case and rotate it 
one-quarter turn to the right, then begin to lower 
the top case onto the bottom case. Do not allow 
the end of the display screen tube to touch the 
assembly behind it and do not pull on the short 
wires. 

42. As you continue to lower the top case, keep the 
inside back of the case against the back of the RF 
shield; this provides the maximum clearance between 
the case and the display screen tube. 
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43. After you have placed the top and bottom cases 
together, rotate the computer one-half turn so that 
the back is facing you. 

44. Replace the single screw in the back and rotate the 
computer one-half turn so that the front of the 
computer is facing you. 

Use a few pieces of tape at the front of the 
keyboard to hold the top and bottom parts of the 
case together as you replace the other screws. 

46. While holding the top and bottom parts of the case 
together at the rear of the keyboard area, place 
the computer on its back and replace one of the 
screws in the bottom case along the front of the 

computer. 

47. Replace the other nine screws in the bottom case. 
Be certain that you return the screws to their 
original locations. 

48. Place the computer upright on the table and remove 
any tape you have applied at the front of the 
keyboard. There should be no parts left over 
except the original character ROM. 
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(For use with the TRSDOS operating system 
supplied by Radio Shack) 



In the front inside pocket of your APL*PLUS/80 binder is 
an APL*PLUS/80 "distribution" disk. The APL*PLUS/80 
distribution disk cannot itself run the APL system. It 
contains only the APL*PLUS/80 system code . It does not 
contain TRSDOS, licensed to you by Tandy Corporation, 
which is needed to run the APL system. You must merge 
the APL*PLUS/80 distribution disk with a TRSDOS system 
disk, creating an APL*PLUS/80 "system" disk. You will 
also need to make a second disk for the APL*PLUS/80 
workspace and file library. (Note that you will need 
three blank disks to be able to perform the following 
steps. ) 





CAUTION 








If you 


have never handled 


dis 


KS 




before 


, be sure to 


read about 


dis 


ks 


and disk drives in 


Chapter 1, 






"System Start-Up", 


before 


beg 


mm 


ng 


these 


installation 


steps. 









To install your APL*PLUS/80 system on a pair of working 
disks: 

1. Remove your TRSDOS Version 1.3 system disk (the INSERT DISKS 
"source" disk) from the disk envelope and insert 
the system disk into drive (the bottom disk 
drive). Insert a new, blank disk (the 
"destination" disk) into disk drive 1 (the top disk 
drive). (See Figure 1.4 which illustrates proper 
disk insertion. ) 
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START UP TRSDOS 



MAKE BACK-UP 
COPY OF TRSDOS 

SYSTEM DISK 



Turn on your TRS-80 Model III using the power 
switch which is located under the right side of the 
keyboard. Flip the power switch to turn on the 
computer; you'll hear a humming and buzzing sound. 
The sound is made by the disk drive motors 
starting. Wait until the disk drive motors stop 
and the drive select light goes off before 
proceeding to the next step; the computer is 
loading and starting the operating system software 
from the TRSDOS system disk in disk drive and 
setting the system clock to midnight. 

After you turn on your TRS-80 and the start-up 
program determines that everything is working 
properly, TRSDOS Version 1.3 displays a picture of 
your TRS-80, the TRSDOS version number and date of 
creation, and the amount of RAM and number of disk 
drives in your system. TRSDOS asks you to enter 
the date in the form MM/DD/YY; For example, 
03/01/82 for March 1, 1982. Type the correct date. 
If you make a mistake while typing, you can correct 
the problem by pressing the backspace key («- on the 
key top) until the cursor erases the incorrect 
character and then typing the correct information. 
When the date is correct, press the ENTER key. 
Note that TRSDOS will not allow you to enter an 
unrealistic date (for example, 13/42/82), and 
TRSDOS will not continue until you enter a date 
that's in the proper format (MM/DD/YY). 



After you enter th 
the time in the fo 
the time in twenty 
14:15:00 for 2:15 
the standard TRS-8 
that is, press the 
with an APL colon 
use the correction 
if necessary. Whe 
ENTER key. TRSDOS 



e date, TRSDOS asks you to enter 
rm HH:MM:SS. You should enter 
-four hour format; for example, 
p.m. Type the correct time using 
keyboard to type the colon; 

key with a : on the key top, not 
on the adhesive label. You can 

procedures described in step 3 
n the time is correct, press the 

displays "TRSDOS Ready". 



Type BACKUP and press the ENTER key; TRSDOS loads 
and starts a program called BACKUP, and asks you to 
enter the source drive number. Type (since your 
"source" disk — the original TRSDOS system disk — 
is in disk drive 0) and press the ENTER key. 
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10, 



11. 



12 



13 



After you enter the source drive number, TRSDOS 
asks you to enter the destination drive number. 
Type 1 (since your "destination" disk -- the _ new, 
blank disk that will become your copy -- is in disk 
drive 1) and press the ENTER key. 

TRSDOS now asks you to enter the source disk master 
password. Type PASSWORD (PASSWORD is the password 
of the original TRSDOS system disk) and press the 
ENTER key. TRSDOS will now copy everything from 
the original TRSDOS system disk in disk drive to 
the new disk in disk drive 1. 

When the copying process is complete, remove the 
original TRSDOS system disk from disk drive 0, 
insert it in the disk envelope, and store it in a 
safe place. Move the back-up copy you have just 
made of your TRSDOS system disk from disk drive 1 
to disk drive 0. Remove the APL*PLUS/80 
distribution disk (it has APL*PLUS/80 System 
printed on the disk label) from the disk envelope 
and insert the distribution disk into disk drive 1 
(with the disk label facing up). 

Type DO COPYAPL and press the ENTER key. This 
copies all of the APL system program files from the 
APL*PLUS/80 distribution disk in disk drive 1 to 
the TRSDOS system disk in disk drive 0. 

When the copying process is complete, disk drive 
will contain your master APL system disk -- a 
complete system disk for operating APL. Remove the 
APL*PLUS/80 distribution disk from disk drive 1, 
insert it in the disk envelope, and set it aside. 

Place a new, blank disk into disk drive 1 so you 
can make an extra copy of your new master APL 
system disk. Type BACKUP and press the ENTER key 
just like you did in step 4; TRSDOS again loads and 
starts the BACKUP program and asks you to enter the 
source drive number. Type and press the ENTER 
key. 

After you enter the source drive number, TRSDOS 
asks you to enter the destination drive number. 
Type 1 and press the ENTER key. 

TRSDOS now asks you to enter the source disk master 
password. Type PASSWORD and press the ENTER key. 



MAKE MASTER 
APL*PLUS/80 
SYSTEM DISK 



MAKE WORKING 
COPY OF 
APL*PLUS/80 
SYSTEM DISK 
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14. when the copying process is complete, remove the 
disk from disk drive 0, and insert it in the disk 
envelope. Using a felt-tip pen to write gently on 
the disk label, identify this disk as your "master 
APL*PLUS/80 system disk" and store it in a safe 
place. Remove the disk from disk drive 1, and 
insert the disk in the disk envelope. Using a 
felt-tip pen to write gently on the disk label, 
identify this disk as your "working APL*PLUS/80 
system disk" (which we will refer to as the 
APL*PLUS/80 system disk throughout this manual). 

15. Insert the APL*PLUS/80 system disk in disk drive 0. 
Insert a blank disk in disk drive 1. Type BACKUP 
and press the ENTER key. TRSDOS loads the BACKUP 
program and asks you to enter the source drive 
number. Before answering this question, remove the 
APL*PLUS/80 system disk from disk 

drive 0, insert it in the disk envelope, and set it 
aside. 



MAKE APL*PLUS/8 
WORKSPACE AND 
FILE LIBRARY DISK 



16. Insert the APL*PLUS/80 distribution disk in disk 
drive with the label side down . This places the 
side with the workspace and file library under the 
disk heads. 

17. You can now answer TRSDOS' request for the source 
drive number. Type and press the ENTER key. 

18. After you enter the source drive number, TRSDOS 
asks you to enter the destination drive number. 

Type 1 and press the ENTER key. 

19. TRSDOS now asks you to enter the source disk master 
password. Type PASSWORD and press the ENTER key. 

20. When "Insert SYSTEM Diskette <ENTER>" appears, 
remove the disk from disk drive 1, and insert it in 
the disk envelope. Using a felt-tip pen to write 
gently on the disk label, identify this disk as 
your "APL*PLUS/80 distribution workspace and file 
library". Re-insert this disk in disk drive 1. 
Remove the APL*PLUS/80 distribution disk from disk 
drive 0, insert it in the disk envelope, and set it 
aside. 



TEST YOUR 
APL SYSTEM 



21. Insert your working APL system disk in disk 
drive and press the ENTER key. 
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22. Test your APL*PLUS/80 System. Press the recessed 
orange system reset button : you'll once again hear 
a humming and buzzing sound. Wait until the drive 
motors stop, the drive select light goes off, and 
TRSDOS displays "TRSDOS Ready". Type APL and press 
the ENTER key to load the APL*PLUS/80 System. (If 
you plan to use your computer primarily for APL, 
you may want to type AUTO APL instead of APL, and 
press the ENTER key. This will automatically load 
the APL*PLUS/BO System whenever you start TRSDOS. ) 
The load process takes about 20 seconds and ends 
with the cursor (a thick, blinking underline) 
reappearing. 

23. Execute a few APL statements and system commands to 
verify that your new APL*PLUS/80 system disk is 
working properly. For example: 

o Type )L0AD SYSTEST and press the ENTER key. 
Your TRS-80 will display a message indicating 
that the workspace is saved. 

o Type SYSTEST and press the ENTER key. Your 

TRS-80 will display test results. The last line 
displayed will be TEST FINISHED. 

o Type )0FF and press the ENTER key. Remove your 
APL*PLUS/80 system disk from disk drive and 
the APL*PLUS/80 distribution workspace and file 
library disk from disk drive 1. Insert them in 
the disk envelopes, and turn off the power 
switch on your TRS-80. 
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(For use with the LDOS operating system 
supplied by Logical Systems, Inc.) 



INSERT SYSTEM 
DISK 



START UP LDOS 



In the front inside pocket of your APL*PLUS/80 binder is 
an APL*PLUS/80 "distribution" disk. The APL*PLUS/80 
distribution disk cannot itself run the APL system. It 
contains only the APL*PLUS/80 system code. It does not 
contain LDOS, licensed to you by Logical Systems, Inc., 
which is needed to run the APL system. You must merge 
the APL*PLUS/80 distribution disk with an LDOS system 
disk, creating an APL*PLUS/80 "system" disk. You will 
also need to make a second disk for the APL*PLUS/80 
workspace and file library. (Note that you will need 
four blank disks to perform the following steps.) 





CAUTION 








If you 


have never handled 


dis 


ks 




before 


, be sure to 


read about 


dis 


ks 


and di 


sk drives in 


Chapter 1 , 






"System Start-Up" , 


before 


beg 


mm 


ng 


these 


installation 


steps. 









To install your APL*PLUS/80 system on a pair of working 
disks: 

l. Remove the LDOS system disk supplied by Logical 

Systems Inc. from the disk envelope and insert the 
system disk into disk drive (the bottom disk 
drive). (See Figure 1.4 which illustrates proper 
disk insertion. ) 



Turn on your TRS-80 Model II 
switch which is located unde 
keyboard. Flip the power sw 
computer; you'll hear a humm 
The sound is made by the dis 
starting. Wait until the di 
and the drive select light g 
proceeding to the next step; 
loading and starting the ope 
from the LDOS system disk in 
setting the system clock to 



I using the power 

r the right side of the 

itch to turn on the 

ing and buzzing sound. 

k drive motors 

sk drive motors stop 

oes off before 

the computer is 
rating system software 

disk drive and 
midnight. 
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LDOS 



After you turn on your TRS-80 and the start-up 
program determines that everything is working 
properly, LDOS displays the LDOS logo and asks you 
to enter the date in the form MM/DD/YY; for 
example, 03/01/82 for March 1, 1982. If you make a 
mistake while typing, you can correct your error by 
pressing the backspace key (*- on the key top) until 
the cursor erases the incorrect character, and then 
typing the correct information. When the date is 
correct, press the ENTER key. Note that LDOS will 
not allow you to enter an unrealistic date (for 
example, 13/42/82), and LDOS will not continue 
until you enter a date that's in the proper format 
(MM/DD/YY) . 



The instructions that follow assume that you are 
using LDOS Version 5.1.2, and the standard TRS-80 
Model III disk drives as supplied by Radio Shack. 
Non-Radio Shack disk drives may call for different 
answers to some of the questions; consult the LDOS 
manual and your disk drive manuals for advice. 



FORMAT A DISK 



Insert a new, blank disk in disk drive 1 (the top 
disk drive). Enter: 

FORMAT :l 

LDOS will now ask questions, to be answered as 
follows : 



DISKETTE NAME? APLMASTR 

MASTER PASSWORD? PASSWORD 

SINGLE OR DOUBLE DENSITY <S,D> ? D 

ENTER NUMBER OF SIDES <1,2> ? 1 

NUMBER OF CYLINDERS? 4 

BOOTSTRAP-STEPPING RATE <6, 12, 20, 30 MSECS> ? 

(Type even though it is not a suggested choice.) 

When "LDOS Ready" appears, enter: 

BACKUP : : 1 



MAKE BACK-UP 
COPY OF LDOS 
SYSTEM DISK 



The BACKUP program may display various alarming 
messages at this stage, such as "DIFFERENT PACK 
IDS! ABORT BACKUP?" (to which you should respond 
NO) or "CAN'T CLEAR MOD FLAGS". These are harmless 
and should be ignored. 

Remove your original LDOS system disk from disk 
drive 0, insert it in the disk envelope, and store 
it in a safe place. 
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Remove the disk from disk drive 1 and insert it in 
the disk envelope. Using a felt-tip pen to write 
gently on the disk label, identify this disk as 
your "master APL*PLUS/80 system disk". Insert your 
"master APL*PLUS/80 system disk" in disk drive 0. 



DELETE UNNEEDED 
LDOS FILES 



MAKE LDOS 
WORKSPACE 
TRANSFER DISK 



Next, create a "minimal" system to make room on 
your system disk for APL by deleting files from 
this disk which are not needed for APL use. Type: 

PURGE :0(I) 

The system displays the names of all files on the 
disk and asks if you want to delete (purge) each 
(Y=yes, delete it; iV=no, leave it). All files 
should be deleted except RS232T/DVR, CONV/CMD, 
FORMAT/CMD, and BACKUP/CMD. (RS2 3 2T/DVR may be 
deleted if you do not intend to use the RS-232 
facilities of APL.) If you later want to retrieve 
a program you've deleted in this step, you can make 
a copy of your original LDOS system disk and then 
repeat step 8 without deleting the program you 
want. 

Insert a new, blank disk in disk drive 1 (the top 
disk drive). Enter: 

FORMAT :1 

LDOS will now ask questions, to be answered as 

follows: 

DISKETTE NAME ? WS-XFER 

MASTER PASSWORD ? PASSWORD 

SINGLE OR DOUBLE DENSITY <S,D> ? D 

ENTER NUMBER OF SIDES <1,2> ? 1 

NUMBER OF CYLINDERS ? 4 

BOOTSTRAP-STEPPING RATE <6, 12, 20, 30 MSECS> ? 

(Type even though it is not a suggested choice.) 

When "LDOS Ready" appears, enter: 

BACKUP : : 1 

The BACKUP program may display various alarming 
messages at this stage, such as "DIFFERENT PACK 
IDS! ABORT BACKUP?" (to which you should respond 
NO) or "CAN'T CLEAR MOD FLAGS". These are harmless 
and should be ignored. 



Copyright 1982 STSC, Inc. 



-70- APL*PLUS/80 Computer User's Guide 



APPENDIX C 



SOFTWARE INSTALLATION INSTRUCTIONS 



LDOS 



10. 



11 



12, 



When "LDOS Ready" appears, remove the disk from 
disk drive 1 and insert it in the disk envelope. 
Using a felt-tip pen to write gently on the disk 
label, identify this disk as your "LDOS workspace 
transfer disk", and set the disk aside. 

Verify that the APL*PLUS/80 distribution disk 
supplied by STSC has write-protect tabs covering 
both write-protect notches. (If not, put 
write-protect tabs over the notches. ) 

Insert the APL*PLUS/80 distribution disk in disk 
drive 1 with the label side up. Enter: 



COPY APL SYSTEM 
FILES FROM 
APL*PLUS/80 
DISTRIBUTION DISK 



CONV /JCL'.l :0 {Q-N) 

When "LDOS Ready" appears, enter: 



DO - LDOSAPL 



13. 



14, 



The system will now convert the TRSDOS files on the 
APL*PLUS/80 distribution disk to LDOS files on the 
master APL*PLUS/80 system disk in disk drive 
(this will take a few minutes). The master 
APL*PLUS/80 system disk now has the APL*PLUS/80 
System on it. 

When "LDOS Ready" appears, remove the APL*PLUS/80 
distribution disk from disk drive 1, insert it in 
the disk envelope, and set it aside. 



Insert a new, 
disk drive). 

FORMAT :1 



blank disk 
Enter : 



in disk drive 1 (the top 



MAKE WORKING 
COPY OF MASTER 
APL*PLUS/80 
SYSTEM DISK 



LDOS will now ask questions, to be answered as 
follows : 



DISKETTE NAME ? APLWRKNG 

MASTER PASSWORD ? PASSWORD 

SINGLE OR DOUBLE DENSITY <S,D> ? D 

ENTER NUMBER OF SIDES <1,2> ? 1 

NUMBER OF CYLINDERS ? 4 

BOOTSTRAP -STEPPING RATE <6, 12, 20, 30 MSECS> _ ? 

(Type even though it is not a suggested choice.) 
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When "LDOS Ready" appears, enter: 

BACKUP :0 :1 

This will copy the APL*PLUS/80 system with LDOS 
onto the disk in disk drive 1. The BACKUP program 
may display various alarming messages at this 
stage, such as "DIFFERENT PACK IDS! ABORT BACKUP?" 
(to which you should respond NO) or "CAN'T CLEAR 
MOD FLAGS". These are harmless and should be 
ignored. When "LDOS Ready" appears, disk drive 1 
will contain a working copy of your APL*PLUS/80 
system disk. 

15. Remove the disk from disk drive 0, insert it in the 
disk envelope, and store it in a safe place. 

16. Remove the disk from disk drive 1 and insert it in 
the disk envelope. Using a felt-tip pen to write 
gently on the disk label, identify this disk as 
your "working APL*PLUS/80 system disk" (which we 
will refer to as the APL*PLUS/80 system disk 
throughout this manual). Set the disk aside. 

17. Insert the disk you created in step 9 (labeled 
"LDOS workspace transfer disk") in disk drive 0. 
Insert the APL*PLUS/80 distribution disk in disk 
drive 1 with the label side down . Enter: 

CONV /AVSil :0 (Q=N) 

When "LDOS Ready" appears, enter: 

CONV /CMD-.l :0 (Q=N) 

When "LDOS Ready" appears, enter: 

LDOSINIT 

18. When "LDOS Ready" appears, remove the disk from 
disk drive 1, insert it in the disk envelope, and 
set it aside. 



MAKE APL*PLUS/80 
WORKSPACE AND 

FILE LIBRARY DISK 



19. Insert a new, blank disk 
disk drive). Enter: 

FORMAT :l 



in disk drive 1 (the top 
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20. 



21. 



22, 



LDOS will now ask questions, to be answered as 
follows : 



DISKETTE NAME ? APLWS+FL 
MASTER PASSWORD ? PASSWORD 
SINGLE OR DOUBLE DENSITY <S,D> 
ENTER NUMBER OF SIDES <1,2> ? 
NUMBER OF CYLINDERS? 4 
BOOTSTRAP-STEPPING RATE <6, 12, 




,) 



20, 30 MSECS> ? 
(Type even though it is not a suggested choice 

When "LDOS Ready" appears, enter: 

BACKUP /AWS-.O :1 



When "LDOS Ready" appears, remove the disk from 
disk drive 1 and insert it in the disk envelope. 
Using a felt-tip pen to write gently on the disk 
label, identify the disk as your "APL*PLUS/80 
workspace and file library", and insert it in disk 
drive 1. 

Remove the disk in disk drive and set it aside; 
it will not be used again for the installation 
process, but you can use it as a blank disk in a 
later step. 

Insert your APL*PLUS/80 system disk in disk 
drive 0. Enter: 

API 

The APL system will load for about 10 seconds and 
display the APL*PLUS/80 logo. An initial workspace 
named INIO will be loaded automatically and will 
display a welcome message. 



START YOUR 

APL*PLUS/80 

SYSTEM 



23. Execute a few APL statements and system commands to 
verify that your new APL*PLUS/80 system disk is 
working properly. For example: 

o Type )L0AD SYSTEST and press the ENTER key. 
Your TRS-80 will display a message showing the 
date that the workspace was saved. 

o Type SYSTEST and press the ENTER key. Your 
TRS-80 will display many lines of output; the 
last line displayed will be TEST FINISHED. 



When you have finished your test session, 
)0FF and press the ENTER key. 



type 



TEST YOUR 

APL*PLUS/80 

SYSTEM 
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BACK-UP APL*PLUS 24, 
WORKSPACE AND FILE 
LIBRARY DISK 



BACK-UP 25, 

NON-SYSTEM DISKS 



Now is a good time to make a back-up copy of the 
APL*PLUS/80 workspace and file library disk in disk 
drive 1. (The instructions in step 14 can be used 
in the future when needed to make a copy of the 
APL*PLUS/80 system disk in disk drive 0.) 

The instructions in this step can be used at any 
time to make a back-up copy of a working data disk 
(without LDOS). Insert your APL*PLUS/80 system 
disk in disk drive and start up LDOS. When "LDOS 
Ready" appears, insert a blank disk (or a disk 
whose data can be discarded) in disk drive 1. 
Enter: 



FORMAT :1 

LDOS will now ask questions, to be answered as 
follows (where the xxxxxxxx is a name of your 
choice ) : 

DISKETTE NAME ? xxxxxxxx 

MASTER PASSWORD ? PASSWORD 

SINGLE OR DOUBLE DENSITY <S,D> ? D 

ENTER NUMBER OF SIDES <1,2> ? 1 

NUMBER OF CYLINDERS ? 4 

BOOTSTRAP-STEPPING RATE <6, 12, 20, 30 MSECS> ? 

(Type even though it is not a suggested choice. ) 

When "LDOS Ready" appears, enter: 

BACKUP :0 :1 (X) 

LDOS asks you to insert the source disk and press 
the ENTER key. Insert the working data disk in 
disk drive and press the ENTER key. After 
processing the back-up, LDOS asks you to insert the 
system disk and press the ENTER key. Remove the 
working data disk from disk drive 0, insert it in 
the disk envelope, and set it aside. Insert the 
APL*PLUS/80 system disk in disk drive and press 
the ENTER key. When "LDOS Ready" appears, remove 
the disk from disk drive 1 and insert it in the 
disk envelope. Using a felt-tip pen to write 
gently on the disk label, identify the disk as a 
copy of the working data disk. 
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When using APL*PLUS/80 under LDOS, experienced APL NOTE TO 
programmers should note that: EXPERIENCED 

APL PROGRAMMERS 
o Since LDOS uses a separate RS-232T driver, if you 

plan to use the communications facility of APL, you 

will need to enter: 

SET *CL RS2Z2T 

before starting the APL system. However, this 
command should not be used if you will not need the 
RS-232 facility in a particular APL session because 
it reduces workspace size by about 350 bytes. 

o The baud rate for RS-232 communications must be set 
by parameters in the LDOS "set" command before 
starting APL. UPOKE 26627 is ignored when operating 
under LDOS. The default value is 300 baud. 

o At present, the LDOS KI/DVR program is not supported 
when operating in APL. 

o To allow overstrikes, line editing, and so on, 
APL*PLUS/80 uses its own video output routine and 
attempts to set, route, or link *DO will be ignored. 
However, turning on the parallel printer port (with 
CTRL 7 or 188 UPOKE 21062), is equivalent to the LDOS 
command LINK *DO *PR and further linkage may be 
carried out via the *PR DCB, using "phantom" control 
blocks if necessary. 
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CTRL B 
(labeled N) 



CTRL C 
( labeled 



-A) 



CTRL E 
(labeled EXP) 



The status line is never displayed. 



The status line is always displayed. 



Shifts into or out of line expansion. In line 
expansion, material that you type is inserted at the 
cursor location, pushing anything at or to the right of 
the cursor further to the right to make room for the 
insertions. 



CTRL I 
(labeled TAB) 



CTRL L 
(labeled LEFT) 

CTRL Q 

(labeled GO) 

CTRL R 
(labeled RIGHT) 



CTRL S 
(labeled STOP) 

CTRL V 

(labeled I ) 



Moves the cursor to the next tab position on the line. 
Tabs are set in every eighth position (1, 9, 17, 25, 33, 
41, 49, 57). Maximum column width is 255 characters. 

Moves the cursor to the extreme left (the first column 
of the input being entered). 

Resumes output that has been halted by a CTRL S. 



Moves the cursor to the extreme right (just past the 
last character you typed on the current line, including 
any spaces that you typed there). 

Causes output to pause. You can resume output with 
CTRL Q, or end output with the BREAK key. 

The status line is displayed during input. 



CTRL W 
(labeled WIPE) 



CTRL Z 
(labeled EDIT) 

CTRL BACK 
(labeled CDEL) 



Clears the unprotected portion of the screen and 
positions the cursor in the upper left corner. The input 
line is discarded. 

Redisplays the last input line for editing and 
re-execution. 

Deletes the character above the cursor, and shifts to 
the left everything to the right of the cursor to fill 
the gap. If there is nothing above the cursor, the 
cursor moves one position to the left and erases the 
character in that position. 
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APPENDIX D 



KEYBOARD AND DISPLAY CONTROL CODES 



Displays a quote-quad (Q) 



Produces a help message, 



CTRL . 
(labeled E) 

CTRL 
(labeled HELP) 



Holds the top 11 lines of the screen in a 
scroll-protected state. Pressing CTRL 1 again releases 
the scroll protection. (For more information on scroll 
protection, see the APL*PLUS/80 Programmer's Reference 
Manual . ) 

Displays a right tack (-0. 



Displays a left tack (t-). 



CTRL 1 
(labeled HOLD) 



CTRL 2 

(labeled /-0 

CTRL 3 

(labeled h) 



Enters or leaves terminal mode (in which you can connect 
your TRS-80 to another computer), and sets or removes the 
TERMINAL note from the status line. (For more 
information on terminal mode, see the APL*PLUS/8 
Programmer's Reference Manual . ) 

Displays a left brace ({). 



Displays a right brace (}) 



CTRL 4 

( labeled 



CTRL 5 
( labeled 

CTRL 6 

( labeled 



TERM) 



{) 



3) 



Turns on or turns off access to a parallel printer. 
(WARNING: Do not press CTRL 7 unless a parallel printer 
is attached to your TRS-80 Model III and is ready to 
print. If a printer is not ready, the system will wait 
for it; to redisplay the cursor, press CTRL 7 again. For 
more information, see the APL*PLUS/80 Programmer's 
Reference Manual. ) 



CTRL 7 
(labeled PRINT) 



Displays a lamp symbol (n) 



Exits to immediate execution mode from another mode of 
operation. (For more information on immediate execution 
mode, see the APL*PLUS/80 Programmer's Reference Manual .) 



CTRL 8 
( labeled 

CTRL 9 
( labeled 



H) 



EXIT) 
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GLOSSARY 



An acronym for A Programming Language, an extremely 
concise, mathematically structured, computer language. 

A full-featured APL language processor for the Radio 
Shack TRS-80 Model III computer. 

A program or group of programs designed to solve a 
specific problem. For example, a general ledger 
application. 

A feature that allows you to hold down any key on the 
keyboard (except CTRL) for about 1/2 second to produce a 
sequence of that character. 

On the TRS-80 Model III, a wheel located under the left 
side of the keyboard that is used to adjust the 
brightness of the screen display. 

A disk drive that is enclosed within the case of your 
TRS-80 Model III. 

A synonym for "automatic character repeat." 

The numbers, letters, and symbols that are recognized by 
your computer. 

An abbreviation for "integrated circuit chip"._ A device 
that consists of ultraminiature transistors, diodes, and 
other components in one physical package forming the 
essential elements of a computer's electronic circuits. 

On the TRS-80 Model III, a wheel located under the left 
side of the keyboard that is used to adjust the contrast 
of the screen display. 

Special codes, created by holding the CTRL key while 
pressing a printing key, that either display an 
additional APL symbol or alter the environment. 

A movable spot of light that appears on the video 
display screen during input and can be positioned 
horizontally by means of keyboard controls to tell the 
computer where the next character you type will appear, 
or where a correction, insertion, deletion, or other 
change is to be made. 

A disk that is used to store APL data and/or APL 
programs. Compare "system disk". 



APL 

APL*PLUS/80 

application 



automatic 
character repeat 



brightness 
control 



built-in 
disk drive 

character repeat 

character set 



chip 



contrast control 



control codes 



cursor 



data disk 
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disk 

diskette 
disk drive 

disk jacket 

disk label 

disk envelope 

display screen 

drive 

drive latch 



drive select 
light 

entry editing 

diagnostic 

messages 



environment 

external 
disk drive 

file 



flexible disk 

floppy disk 

graphics 
characters 



A low-cost storage device that consists of a flexible 
platter of magnetically coated mylar that is enclosed in 
a plastic jacket. The entire jacket is inserted in the 
disk drive. 

A synonym for "disk". 

A device that electromagnetically reads information 
from, or writes information on, a disk. 

The 5 1/4- inch square protective plastic cover enclosing 
a disk. 

The adhesive label that is affixed to the disk jacket. 
The disk label is used for recording information about 
the disk. 

The paper container used to store a disk when it is not 
in use. 

A synonym for "video display screen." 

A synonym for "disk drive" . 

The door that is used to control access of disks into 
and out of the disk drive. 

The red light on a disk drive that comes on when the 
computer is trying to use the disk drive. 

Warning messages that appear on the status line 
indicating that the computer can't work with the 
information you've entered; for example, UNKNOWN 
OVERSTRIKE, OPEN QUOTE. 

The mode of operation of a computer. 

A disk drive that is attached to, but separate from, 
your TRS-80 Model III . 

A named collection of data stored on a disk in a 
prescribed sequence. The user can store information on, 
and retrieve information from, a file. 

A synonym for "disk". 

A synonym for "disk". 

Characters composed of "white spots" in various 
combinations within a two-spot-wide by three-spot-high 
pattern. 
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Various methods that can be used to correct or change 
user entries before the ENTER key is pressed. 

The portion of the TRS-80 Model III that contains the 
typewriter-like keys used for communi eating with the 
computer. 

An alternate operating system for the TRS-80 Model III, 
licensed by Logical Systems, Inc. 

A twelve-key section to the right of the main TRS-80 
Model III keyboard. 

A data file that is activated for use in the current 
computer session. 

The large system program that supervises and controls 
the execution of other computer programs and provides 
various services (such as input and output) for other 

programs. 

(To form) a character by using the backspace key to 
superimpose one character on top of another; for 
example, a SHIFT K ('), backspace, period (.) forms the 
overstrike character called shriek (!). 

A name that is used to extend the identification of a 
user or a workspace, thereby decreasing the possibility 
of unauthorized access. 

A separate machine connected to your computer, such as 
an external disk drive, cassette tape unit, or printer. 

On the TRS-80 Model III, a rocker switch located under 
the right side of the keyboard that is used to turn the 
power supply to the computer on and off. 

On the TRS-80 keyboard, a key that causes a character to 
appear on the video display screen. 

(To develop) a set of sequenced instructions that cause 
a computer to perform particular operations. 

An acronym for Random-Access Memory; a type of computer 
memory that provides access to any location, allowing 
data to be written to or read from any location. 

A small electromagnet used to read, write, or erase data 
on a magnetic storage device; for example, a disk or 
tape. 

An oval opening in a disk jacket that allows the 
read/write head of a disk drive to access the platter. 



input editing 
commands 

keyboard 



LDOS 

numeric pad 
open file 
operating system 

overstrike 

password 

peripheral device 
power switch 

printing key 

program 

RAM 

read/write head 

read/write window 
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remote computer 

repeat 
ROM 

special character 
start-up program 

status line 
status line note 

system clock 

system code 
system disk 



system reset 
button 



text characters 



TRSDOS 



underbar 



A computer that is distant from your TRS-80 Model III; 
that is, in another room, city, state, or country. 

See "automatic character repeat". 

An acronym for Read-Only Memory; a memory circuit used 
to provide a means of storing a fixed program in your 
TRS-80 Model III. 

A character that is neither a letter nor a number; for 
example, ! & /. 

A program in the operating system that tests the 

computer and asks you to enter the date whenever you 

turn on your computer or press the orange system reset 
button. 

A line at the bottom of the screen where notes are 
displayed to give you information about the system. 

Information about the system that is displayed in the 
Status line; for example, EXPAND, UNKNOWN OVERSTRIKE, 
OPEN QUOTE. 

The time-of-day value that is continually updated by the 
operating system; you must give the computer a current 
time whenever you turn on your computer or press the 
orange reset button. 

The part of the APL*PLUS/80 system software that tells 
the computer what to do with APL commands. 

A disk (used in disk drive on your TRS-8 Model III) 
that contains a copy of the system programs (operating 
system and APL language processor). 

The recessed orange button at the right edge of the 
TRS-80 Model III keyboard which discards everything in 
your computer's memory (except the date) and reloads 
TRSDOS from the system disk in disk drive 0. 

Printing characters in the APL*PLUS/80 character set 
other than graphics characters or special characters. 

The operating system for the TRS-80 Model III, supplied 
to you by Radio Shack and licensed to you for use on 
your computer. 

In APL, the symbol _ (SHIFT F). Also called underscore. 
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The area of your TRS-80 Model III that resembles a video display 

television screen. screen 

An area on a disk that is used to tell a disk drive .write-protect 

whether the computer is allowed to write (store programs notch 
and data files) on the disk. 
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REFERENCES 

The publications listed below will provide you with additional 
information about the APL language, APL*PLUS/80 System features, 
and your TRS-80 Model III. 

1. APL; An Interactive Approach . L. Gilman and A. J. Rose, 
John Wiley £. Sons, Inc., 1976. Provides a detailed 
introduction to APL on a broad selection of topics. 

2. APL Is Easy. STSC, 1982. Provides an introduction to APL that 
has been developed specifically for people beginning to use 
APL. 

3. APL*PLUS /80Fprmatting User's Guide , STSC, 1982. Describes the 
features available in your system for creating formatted 
reports. 

t • APL*PLU S/80 Programmer's Reference Manua l , STSC , 19 8 2. 
Provides both general information and specific reference 
material for the features in your system, and includes many 
helpful hints on efficient programming. 

5 • APL*PLUS/8p, Sha red File System User's Guide , STSC , 19 8 2. 
Describes the operation of files in your system. 

6. TRS-80 Model III Disk System Owner's Manual . Tandy Corporation, 
1980. Describes the operation of your TRS-80, and the TRSDOS 
command language. 
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INDEX 



Adjusting screen display 15 
Alphabetic characters 22 
APL character set 29 

labels 21 
APL keyboard 19-26 
APL start-up dialog 16 
AUTO APL command 16 
Automatic character repeat 25-6 



Disk drive, 

built-in 6, 10-1 
external 6, 10-1 
Disk drive cleaning 52 
Disk drive number 10-1 
Display screen, video 6, 
Drive latch 10-1 
Drive select light 10-1 



27-31 



BACK key 22, 24, 34 

Back-up disk copies 
Backspace 31-5 
BREAK key 2 4, 38 
Brightness control 
Built-in disk drive 



•5 
52-3 



6, 15 
6, 10-1 



CDEL key 3 5-6 

Character delete 35-6 

Character repeat, automatic 25-6 

Character set, APL 29 

Character set labels, APL 21 

Characters, 

alphabetic 22 

graphic 29 

lowercase 22 

numeric 23-4 

shifted 22 

special 29 

unshifted 22 

uppercase 2 2 
CHARSET 2 9 

Cleaning disk drives 52 
Color-coded keys 21 
Compressing data files 53-4 
Contrast control 6, 15 
Control codes, keyboard and display 
CTRL key 23-4, 26 
Cursor 22, 30 
Cursor movement 22, 30, 37-8 



Data disk 11, 13 
Disk 7-9 

back-up copies 52-3 

care 8-9 

envelope 7-8 

formatting 52 

handling 8-9 

insertion 11, 13 

jacket 7-8 

label 7 

read/write window 7-8 

removal 4 5 

write-protect notch 7-8 
Disk, 

data 11, 13 

system 11, 13 



Editing keyboard entries 16, 33-42 

Ending an APL session 4 5 

ENTER key 24 

Entry editing diagnostics 40-42 

open quote 4 2 

unknown overstrike 40-1 
EXP key 36-7 
External disk drive 6, 10-1 



File size design 54 
Formatting disks 52 



Graphic characters 29 



HELP key 2 6 



Indent, six-space 30 
Input editing commands 34-40 
backspace 34-5 
BREAK key 3 8 
character delete 35-6 
cursor movement 37-8 
line expansion 36-7 
2 6 RDEL key 3 8 

statement recall 38-40 
Inserting disks 11, 13 



KE key 2 4 

Keyboard 6 

Keyboard, APL 19-2 6 

Keyboard and display control codes 



LEFT key 3 7 

Line expansion 36-7 

)LOAD 45, 4 8 

Lowercase characters 22 



26 



Numeric characters 
Numeric pad 23-4 

Open quote 4 2 



23-4 
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Peripheral devices 12 
Power switch 6, 14 



RDEL key 24, 3 8 

Read/write window 7-8 

Removing disks 45 

Reset button, system 6 

Retrieving stored information 

RIGHT key 3 8 

Running a stored program 48 



45, 48 



)SAVE 4 4 

Saving data and programs 44-5 

Screen display, adjusting 15 

SHIFT key 22, 2 5 

Shifted characters 22 

Shut-down steps 43-6, 49 

summary 46, 4 9 
Six-space indent 30 
SLOWER key 2 5 
Special characters 29 
Special keys 24 
Start-up dialog, APL 16 
Start-up dialog, TRSDOS 16 
Start-up steps 12-8, 48 

summary 18, 4 8 
Statement recall 38-40 
Status line 17, 29 

notes 29 
System disk 11 
System reset button 6 
System shut-down 43-6 



TAB key 30-1, 38 

Tab stops 30-1 

TE key 2 5 

TRSDOS start-up dialog 



16 



Unknown overstrike 40-1 
Unshifted characters 22 
Uppercase characters 22 

User responsibilities 51-4 



Video display screen 6, 27-31 



Write-protect notch 7-! 
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We write our publications to help you. You can help us by filling out and returning FEEDBACK. 
Your reply will be forwarded to the person who can best benefit from your comments. 



1 . Is the writing straightforward and clear? 

2. Is the material organized well? 

3. Are the examples clear and well chosen? 

4. Do the illustrations (figures and tables) clarify the material? 

5. Do you find the size of the publication and the way it is bound 
convenient? 

6. Are there errors, or misleading information, in the publication? 
If so, where do they occur? 



Yes □ 
Yes □ 
Yes □ 
Yes □ 
Yes □ 



No D 
No □ 
No □ 
No □ 
No □ 



Yes □ No D 



7. Did you find any parts of the publication unduly hard to 
understand? If so, which are they? 



Yes D 



No D 



How can we change this publication to make it more useful to you? (If you need more room, 
please write on the back.) 



Thank you for your comments. No postage is necessary if mailed in the U.S.A. 
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